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

مسیرهای سازگار با OpenAI: چت، Responses، امبدینگ، تصویر، صدا و ویدیو

آدرس پایهٔ https://1xai.ir/v1 همان مسیرهای API رسمی OpenAI را می‌پذیرد. بدنهٔ درخواست بدون ترجمه به سازندهٔ مدل می‌رسد، جز چند تغییر مشخص که در همین صفحه فهرست شده است. این صفحه برای هر مسیری که کار می‌کند یک بخش دارد؛ مسیرهایی که کار نمی‌کنند در صفحهٔ مسیرهای پشتیبانی‌نشده‌اند.

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

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

مسیرهای سازگار با OpenAI · ۱

فهرست مسیرها

مسیرهای /v1 که کار می‌کنند
مسیرکارهزینه بر اساس
POST /v1/chat/completionsچت، برای مدل‌های همهٔ سازنده‌هاتوکن
POST /v1/responsesResponses API، فقط مدل‌های OpenAIتوکن، و هر جست‌وجوی وب
POST /v1/embeddingsبردار متنتوکن
POST /v1/images/generations, /edits, /variationsساخت و ویرایش تصویرتصویر یا توکن، بسته به مدل
POST /v1/audio/speechمتن به گفتارنویسهٔ ورودی
POST /v1/audio/transcriptions, /translationsگفتار به متندقیقهٔ صدا، یا توکن برای مدل Gemini
POST /v1/videosساخت ویدیو به شکل API ویدیوی OpenAIثانیهٔ ویدیو
POST /v1/completionsتکمیل متن قدیمیتوکن
POST /v1/files, /v1/batchesپردازش دسته‌ای OpenAI: چت و امبدینگ، نتیجه تا ۲۴ ساعت بعدتوکن، با ۵۰٪ قیمت عادی
POST /v1/moderations, /v1/responses/input_tokensبررسی محتوا و شمارش توکنرایگان
GET /v1/models, /v1/models/{id}فهرست مدل‌هارایگان

مسیر Anthropic (POST /v1/messages) هم روی همین آدرس پایه هست و در Anthropic آمده است. API حساب (/v1/usage، /v1/wallet، /v1/keys) و ساخت کلید موقت تماس صوتی (صوت زنده) هم زیر /v1 هستند.

مسیرهای سازگار با OpenAI · ۲

آنچه دروازه در درخواست تغییر می‌دهد

دروازه بدنهٔ درخواست را ترجمه نمی‌کند: tools، tool_choice، response_format، بخش‌های تصویر و صدا و پارامترهای استدلال همان‌طور که فرستاده‌ای به سازنده می‌رسند. این‌ها تنها تغییرها هستند:

تغییرهای دروازه در بدنهٔ درخواست
تغییرکجاچرا
نام مدل بازنشسته به مدل جانشین عوض می‌شودهمهٔ مسیرهاتا تنظیم قدیمی از کار نیفتد؛ پاسخ هدر X-1xai-Model-Alias دارد
store روی false گذاشته می‌شودمدل‌های OpenAI در chat/completions و responsesدرخواست نزد سازنده ذخیره نشود
stream_options.include_usage روشن می‌شودهر استریم جز responsesهزینه از شمار توکن آخرین تکه حساب می‌شود
max_tokens به max_completion_tokens تبدیل می‌شودمدل‌های OpenAI در chat/completionsمدل‌های تازه فقط نام دوم را می‌پذیرند
سقف خروجی پایین می‌آید یا گذاشته می‌شودهر مسیر توکنی جز responsesوقتی اعتبار کفاف سقف خواسته‌شده را نمی‌دهد (صورت‌حساب)
temperature، top_p و جریمه‌های تکرار حذف می‌شوندمدل‌های استدلالی OpenAI که فقط مقدار پیش‌فرض را می‌پذیرندبه جای خطای 400 سازنده
response_format از json_schema به json_object و نقش developer به system تبدیل می‌شودمدل‌های DeepSeekاین مدل‌ها شکل اول را نمی‌پذیرند

service_tier با هر مقداری جز auto و default خطای 400 با کد invalid_request می‌گیرد، چون هر مدل یک نرخ منتشرشده دارد.

مسیرهای سازگار با OpenAI · ۳

چت: POST /v1/chat/completions

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": "سلام"}]
  }'
  • مدل‌های هر ۱۰ سازنده روی این مسیر جواب می‌دهند؛ نام مدل سازنده را تعیین می‌کند (مدل‌ها).
  • مدل‌های Anthropic و Google از راه نقطهٔ پایانی سازگار با OpenAI خود آن سازنده صدا زده می‌شوند، پس آنچه آن نقطهٔ پایانی پشتیبانی می‌کند همین‌جا کار می‌کند.
  • کش پرامپت Anthropic با cache_control، فکر گسترده و استنادها فقط روی مسیر نیتیو Anthropic در دسترس‌اند.
  • ابزارها، خروجی ساختاریافته و ورودی تصویر در فراخوانی تابع و خروجی ساختاریافته آمده است؛ استریم در استریم.
  • مدل تصویر، صدا یا ویدیو روی این مسیر خطای 400 می‌گیرد و پیام خطا مسیر درست را می‌گوید.

مسیرهای سازگار با OpenAI · ۴

Responses: POST /v1/responses

POST /v1/responses

با جست‌وجوی وب

curl
curl https://1xai.ir/v1/responses \
  -H "Authorization: Bearer 1xai-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "سه خبر مهم امروز دربارهٔ هوش مصنوعی چیست؟",
    "tools": [{"type": "web_search"}]
  }'
  • فقط مدل‌های OpenAI. مدل سازندهٔ دیگر خطای 400 با کد invalid_request می‌گیرد؛ آن مدل را روی /v1/chat/completions صدا بزن.
  • ابزار web_search مجاز است و به‌ازای هر جست‌وجو، با نرخ جست‌وجوی همان مدل، جدا از توکن‌ها حساب می‌شود. پیش از تماس مبلغ ۳ جست‌وجو رزرو می‌شود (یا کمتر، اگر max_tool_calls کمتر باشد) و پس از پاسخ به اندازهٔ جست‌وجوهای انجام‌شده کم می‌شود.
  • ابزارهای تابعی (function و custom) مجازند.
  • code_interpreter، file_search، image_generation، computer_use و mcp خطای 400 با کد hosted_tool_unmetered می‌گیرند.
  • background: true خطای 400 با کد path_unmetered می‌گیرد؛ همان درخواست را بدون آن بفرست.
  • پاسخ‌ها ذخیره نمی‌شوند (store همیشه false است)، پس خواندن، لغو یا حذف یک پاسخ با شناسه (/v1/responses/{id}) خطای 402 با کد path_unmetered می‌گیرد.

مسیرهای سازگار با OpenAI · ۵

امبدینگ: POST /v1/embeddings

POST /v1/embeddings
curl
curl https://1xai.ir/v1/embeddings \
  -H "Authorization: Bearer 1xai-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "text-embedding-3-small", "input": ["متن اول", "متن دوم"]}'

هزینه بر اساس توکن ورودی است. پاسخ همان شکل OpenAI را دارد.

مسیرهای سازگار با OpenAI · ۶

تصویر: POST /v1/images/generations و ویرایش

POST /v1/images/generations
curl
curl https://1xai.ir/v1/images/generations \
  -H "Authorization: Bearer 1xai-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-image-2", "prompt": "یک فنجان چای روی میز چوبی، نور صبح", "size": "1024x1024"}'
POST /v1/images/edits

ویرایش با فرم multipart

curl
curl https://1xai.ir/v1/images/edits \
  -H "Authorization: Bearer 1xai-..." \
  -F model="gpt-image-2" \
  -F image="@photo.png" \
  -F prompt="پس‌زمینه را سفید کن"
  • اگر در درخواست JSON فیلد model نباشد، gpt-image-2 به کار می‌رود. در فرم multipart فیلد model لازم است.
  • هزینه بسته به مدل یا به‌ازای هر تصویر است (بر اساس اندازه و کیفیت) یا بر اساس توکن‌های متن و تصویر.
  • stream: true در ساخت تصویر خطای 400 با کد path_unmetered می‌گیرد.
  • مدل‌های تصویر Google روی این مسیر نیستند؛ آن‌ها را روی مسیر نیتیو :generateContent صدا بزن (Gemini).
  • پاسخ همان پاسخ سازنده است.

مسیرهای سازگار با OpenAI · ۷

صدا: گفتار و رونویسی

POST /v1/audio/speech
curl
curl https://1xai.ir/v1/audio/speech \
  -H "Authorization: Bearer 1xai-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o-mini-tts", "voice": "alloy", "input": "سلام، به 1xAi خوش آمدی."}' \
  --output speech.mp3
POST /v1/audio/transcriptions
curl
curl https://1xai.ir/v1/audio/transcriptions \
  -H "Authorization: Bearer 1xai-..." \
  -F model="gpt-4o-transcribe" \
  -F file="@voice.mp3"
  • /v1/audio/speech: هزینه بر اساس شمار نویسه‌های input. بدنهٔ درخواست تا ۱ مگابایت.
  • /v1/audio/transcriptions و /v1/audio/translations: فرم multipart با file و model؛ هزینه بر اساس مدت صدا. فایل تا ۲۵ مگابایت.
  • مدل gemini-3.5-transcribe هم روی /v1/audio/transcriptions با همان فرم کار می‌کند: response_format فقط json یا text (بدون verbose_json، srt، vtt و stream)، هزینه بر اساس توکن. ویس تلگرام و واتس‌اپ (ogg/opus) را همان‌طور که هست می‌پذیرد. روی /v1/audio/translations کار نمی‌کند.
  • گفت‌وگوی صوتی دوطرفه راهنمای خودش را دارد: صوت زنده.

مسیرهای سازگار با OpenAI · ۸

ویدیو

  • ساخت ویدیو امروز با مدل gemini-omni-1.1-flash روی مسیر نیتیو Gemini انجام می‌شود: Gemini، بخش ویدیو.
  • مسیرهای POST /v1/videos، GET /v1/videos/{id}، GET /v1/videos/{id}/content و POST /v1/videos/{id}/remix به شکل API ویدیوی OpenAI پاسخ می‌دهند و بر اساس ثانیهٔ ویدیو حساب می‌شوند؛ گرفتن وضعیت و دانلود رایگان است.
  • مدل‌های Sora را سازنده بازنشسته کرده است؛ درخواست با آن‌ها 410 با کد model_retired می‌گیرد. فهرست کردن و حذف ویدیو (GET /v1/videos، DELETE) در دسترس نیست.

مسیرهای سازگار با OpenAI · ۹

تکمیل متن قدیمی: POST /v1/completions

مسیر قدیمی تکمیل متن با فیلد prompt برای مدل‌هایی که هنوز آن را می‌پذیرند کار می‌کند و مثل چت بر اساس توکن حساب می‌شود. برای کار تازه از /v1/chat/completions استفاده کن.

مسیرهای سازگار با OpenAI · ۱۰

مسیرهای رایگان

POST /v1/moderations، POST /v1/responses/input_tokens، POST /v1/messages/count_tokens، GET /v1/models و گرفتن وضعیت یک ویدیو هزینه‌ای ندارند. این مسیرها هم کلید می‌خواهند و در سقف نرخ کلید شمرده می‌شوند.