مسیرهای سازگار با OpenAI: چت، Responses، امبدینگ، تصویر، صدا و ویدیو
آدرس پایهٔ https://1xai.ir/v1 همان مسیرهای API رسمی OpenAI را میپذیرد. بدنهٔ درخواست بدون ترجمه به سازندهٔ مدل میرسد، جز چند تغییر مشخص که در همین صفحه فهرست شده است. این صفحه برای هر مسیری که کار میکند یک بخش دارد؛ مسیرهایی که کار نمیکنند در صفحهٔ مسیرهای پشتیبانینشدهاند.
آخرین بهروزرسانی:
فهرست مستندات
مسیرهای API
حساب، کلید و تیم
مسیرهای سازگار با OpenAI · ۱
فهرست مسیرها
| مسیر | کار | هزینه بر اساس |
|---|---|---|
POST /v1/chat/completions | چت، برای مدلهای همهٔ سازندهها | توکن |
POST /v1/responses | Responses 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
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
با جستوجوی وب
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
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 و ویرایش
curl https://1xai.ir/v1/images/generations \
-H "Authorization: Bearer 1xai-..." \
-H "Content-Type: application/json" \
-d '{"model": "gpt-image-2", "prompt": "یک فنجان چای روی میز چوبی، نور صبح", "size": "1024x1024"}'ویرایش با فرم multipart
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 · ۷
صدا: گفتار و رونویسی
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.mp3curl 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 و گرفتن وضعیت یک ویدیو هزینهای ندارند. این مسیرها هم کلید میخواهند و در سقف نرخ کلید شمرده میشوند.