مدلهای API: شمار، سازندهها و مسیر هر مدل
یک کلید به مدلهای ۱۰ سازنده میرسد و نام مدل تعیین میکند درخواست به کدام سازنده برود. امروز ۱۳۰ مدل متنی قیمتگذاریشده از ۱۰ سازنده در فهرست است؛ مدلهای تصویر، صدا، ویدیو و صوت زنده جدا از این شمارشاند. فهرست زنده با قیمت تومانی در صفحهٔ مدلها است. GET /v1/models همان فهرست را برای برنامه برمیگرداند.
آخرین بهروزرسانی:
فهرست مستندات
مسیرهای API
حساب، کلید و تیم
مدلها · ۱
شمار مدلها
امروز ۱۳۰ مدل متنی قیمتگذاریشده از ۱۰ سازنده در فهرست است؛ مدلهای تصویر، صدا، ویدیو و صوت زنده جدا از این شمارشاند. فهرست زنده با قیمت تومانی در صفحهٔ مدلها است.
| سازنده | شمار مدل |
|---|---|
| OpenAI | ۵۳ |
| Anthropic | ۱۸ |
| ۳۱ | |
| DeepSeek | ۱۰ |
| xAI | ۱ |
| Moonshot AI | ۳ |
| Z.ai | ۵ |
| Alibaba Qwen | ۵ |
| MiniMax | ۲ |
| Tencent Hunyuan | ۲ |
| نوع | شمار مدل |
|---|---|
| چت | ۸۵ |
| استدلالی | ۴۰ |
| امبدینگ | ۵ |
این عددها هر بار از همان فهرست قیمتی خوانده میشوند که صفحهٔ قیمتها نشان میدهد؛ جایی دستی نوشته نشدهاند.
مدلها · ۲
مسیریابی با نام مدل
| نام مدل با این شروع میشود | سازنده | مسیرها |
|---|---|---|
claude- | Anthropic | /v1/chat/completions و مسیر نیتیو /anthropic |
gemini-, gemma- | /v1/chat/completions و مسیر نیتیو /gemini | |
deepseek- | DeepSeek | /v1/chat/completions |
grok- | xAI | /v1/chat/completions |
kimi- | Moonshot AI | /v1/chat/completions |
glm- | Z.ai | /v1/chat/completions |
qwen | Alibaba Qwen | /v1/chat/completions |
minimax- | MiniMax | /v1/chat/completions |
hunyuan-, hy | Tencent Hunyuan | /v1/chat/completions |
| هر نام دیگر | OpenAI | همهٔ مسیرهای /v1 |
نام مدل را دقیقاً همانطور بنویس که GET /v1/models برمیگرداند. مسیریابی به بزرگی و کوچکی حروف حساس نیست، ولی فهرست قیمت هست: نامی با حروف بزرگ (مثل GPT-4o-mini به جای gpt-4o-mini) خطای 402 با کد model_not_priced میگیرد. برای عوض کردن سازنده فقط فیلد model را عوض کن؛ کلید و آدرس پایه ثابت میمانند. کدام مسیر چه چیزی را پشتیبانی میکند در مسیرهای سازگار با OpenAI، Anthropic و Gemini آمده است.
مدلها · ۳
فهرست مدلها از API
curl https://1xai.ir/v1/models \
-H "Authorization: Bearer 1xai-..."- پاسخ همان شکل
GET /v1/modelsدر OpenAI را دارد:{"object":"list","data":[{"id","object":"model","created","owned_by",…}]}، و هر مدل سه فیلد بیشتر هم دارد (جدول زیر). - فقط مدلهایی در فهرستاند که قیمت دارند و قابل صدا زدناند؛ مدلهای تصویر، صدا و ویدیو هم در همین فهرست میآیند.
- این مسیر رایگان است.
GET /v1/models/{id}یک مدل را برمیگرداند؛ برای مدل بازنشسته410با کدmodel_retired.
| فیلد | نوع | معنی |
|---|---|---|
type | string | نوع مدل: chat (چت، Responses، Messages و generateContent)، embedding، image، video، transcription، speech، realtime، music، moderation یا rerank. ممکن است مقدار تازهای اضافه شود. |
context_window | integer | توکن ورودیای که مدل میپذیرد؛ برای مدلهای chat و embedding، وقتی معلوم است. |
max_output_tokens | integer | بیشترین توکن خروجی مدل؛ برای مدلهای chat، وقتی معلوم است. |
فیلدی که معلوم نیست حذف میشود و هرگز حدس زده نمیشود. فیلدهای قبلی هر مدل (و هر فیلد دیگری که سازنده فرستاده) دست نمیخورند. همین سه فیلد روی GET /v1/models/{id} هم هست.
یک مدل در فهرست
{
"id": "gpt-5.5",
"object": "model",
"created": 1767225600,
"owned_by": "openai",
"type": "chat",
"context_window": 400000,
"max_output_tokens": 128000
}مدلها · ۴
مدلهای بازنشسته و نامهای قدیمی
- وقتی سازنده نام مدلی را بازنشسته میکند و جانشین مستقیم دارد، دروازه همان نام قدیمی را به مدل جانشین میفرستد تا تنظیمهای قدیمی از کار نیفتند.
- در این حالت پاسخ هدر
X-1xai-Model-Aliasدارد، به شکلنام خواستهشده -> نام اجراشده، و فیلدmodelدر بدنهٔ پاسخ نام مدل اجراشده است. - هزینه با قیمت مدلی حساب میشود که واقعاً اجرا شده است.
- مدلی که بازنشسته شده و جانشینی برایش تعریف نشده،
410با کدmodel_retiredیا402با کدmodel_not_pricedمیگیرد.
X-1xai-Model-Alias: gemini-2.0-flash -> gemini-2.5-flash