۱۰۰ هزار تومان هدیهٔ ثبت‌نام، تا ۱ میلیونبا ثبت‌نام گردونهٔ هدیه را بچرخان: دست‌کم ۱۰۰٬۰۰۰ تومان و تا ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه، بدون کارت بانکیگردونهٔ هدیه۱ میلیون برای تو، ۱ میلیون برای دوستتدوستانت را دعوت کن: برای هر دوستی که فعال شود ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه می‌گیری و خودش هم ۱٬۰۰۰٬۰۰۰ تومانجوایز
1xAi
مستندات API

شروع سریع API: اولین درخواست در چند دقیقه

حساب بساز، یک کلید 1xai-* بگیر، آدرس پایهٔ کتابخانهٔ OpenAI را روی https://1xai.ir/v1 بگذار و درخواست بفرست. همان کلید و همان آدرس به مدل‌های ۱۰ سازنده می‌رسد و هزینه به تومان از کیف پول کم می‌شود. حساب تازه یک بار گردونهٔ هدیه را می‌چرخاند و می‌تواند پیش از هر پرداختی API را امتحان کند.

آخرین به‌روزرسانی:

فهرست مستندات

شروع سریع · ۱

گام‌ها

  1. حساب بساز. در صفحهٔ ثبت‌نام با ایمیل یا شمارهٔ موبایل ثبت‌نام و آن را تأیید کن.
  2. پروفایل هویتی را کامل کن. در /onboarding نام کامل، کد ملی و شمارهٔ موبایل را ثبت کن. تا این پروفایل کامل نشود داشبورد کلید صادر نمی‌کند و شارژ ممکن نیست.
  3. گردونهٔ هدیه را بچرخان. از ۱۰۰٬۰۰۰ تومان تا ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه برای مدل‌های سریع و ارزان، به‌علاوهٔ ۳۰٬۰۰۰ تومان برای هر مدلی؛ هر دو ۱۴ روز اعتبار دارند و روی تماس‌های API خرج می‌شوند.
  4. کلید بساز. در کلیدهای API یک کلید صادر و همان لحظه کپی کن؛ کلید کامل فقط یک بار نمایش داده می‌شود (کلیدها و امنیت).
  5. درخواست بفرست. یکی از سه نمونهٔ پایین. برای عوض کردن سازنده فقط فیلد model را عوض کن: gpt-5.5، claude-sonnet-5 یا gemini-3.5-flash.
  6. مصرف را ببین. همان تماس با هزینهٔ تومانی، توکن‌ها و زمانش در داشبورد و در GET /v1/usage هست (API حساب).

شروع سریع · ۲

اولین درخواست

POST /v1/chat/completions
curl
curl https://1xai.ir/v1/chat/completions \
  -H "Authorization: Bearer 1xai-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "سلام"}]
  }'

کتابخانهٔ رسمی OpenAI

Python
from openai import OpenAI

client = OpenAI(
    base_url="https://1xai.ir/v1",
    api_key="1xai-...",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "سلام"}],
)
print(resp.choices[0].message.content)

بستهٔ openai در npm

JavaScript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://1xai.ir/v1",
  apiKey: "1xai-...",
});

const resp = await client.chat.completions.create({
  model: "gemini-3.5-flash",
  messages: [{ role: "user", content: "سلام" }],
});
console.log(resp.choices[0].message.content);

پاسخ همان شکل پاسخ OpenAI را دارد. هدرهای X-RateLimit-* می‌گویند از سقف ۱٬۰۰۰ درخواست در دقیقهٔ کلید چقدر مانده است (محدودیت نرخ).

شروع سریع · ۳

آدرس‌های پایه

آدرس‌های پایه
برایآدرس پایه
کتابخانه‌ها و ابزارهای سازگار با OpenAIhttps://1xai.ir/v1
کتابخانهٔ رسمی Anthropic و Claude Codehttps://1xai.ir/anthropic
کتابخانهٔ رسمی Google GenAIhttps://1xai.ir/gemini

سرورهای اصلی 1xAi بیرون از ایران هستند. نشانی api.1xai.ir از یک سرور ما در ایران می‌گذرد که اتصال رمزشده را باز نمی‌کند؛ هر دو نشانی به همان سرویس می‌رسند و بدون فیلترشکن از ایران در دسترس‌اند. روی https://api.1xai.ir همان مسیرها و همان کلیدها کار می‌کنند.

شروع سریع · ۴

قدم بعد