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

مدل‌های API: شمار، سازنده‌ها و مسیر هر مدل

یک کلید به مدل‌های ۱۰ سازنده می‌رسد و نام مدل تعیین می‌کند درخواست به کدام سازنده برود. امروز ۱۳۰ مدل متنی قیمت‌گذاری‌شده از ۱۰ سازنده در فهرست است؛ مدل‌های تصویر، صدا، ویدیو و صوت زنده جدا از این شمارش‌اند. فهرست زنده با قیمت تومانی در صفحهٔ مدل‌ها است. GET /v1/models همان فهرست را برای برنامه برمی‌گرداند.

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

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

مدل‌ها · ۱

شمار مدل‌ها

امروز ۱۳۰ مدل متنی قیمت‌گذاری‌شده از ۱۰ سازنده در فهرست است؛ مدل‌های تصویر، صدا، ویدیو و صوت زنده جدا از این شمارش‌اند. فهرست زنده با قیمت تومانی در صفحهٔ مدل‌ها است.

شمار مدل‌های متنی هر سازنده
سازندهشمار مدل
OpenAI۵۳
Anthropic۱۸
Google۳۱
DeepSeek۱۰
xAI۱
Moonshot AI۳
Z.ai۵
Alibaba Qwen۵
MiniMax۲
Tencent Hunyuan۲
شمار مدل‌های متنی بر اساس نوع
نوعشمار مدل
چت۸۵
استدلالی۴۰
امبدینگ۵

این عددها هر بار از همان فهرست قیمتی خوانده می‌شوند که صفحهٔ قیمت‌ها نشان می‌دهد؛ جایی دستی نوشته نشده‌اند.

مدل‌ها · ۲

مسیریابی با نام مدل

نام مدل و سازنده
نام مدل با این شروع می‌شودسازندهمسیرها
claude-Anthropic/v1/chat/completions و مسیر نیتیو /anthropic
gemini-, gemma-Google/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
qwenAlibaba Qwen/v1/chat/completions
minimax-MiniMax/v1/chat/completions
hunyuan-, hyTencent Hunyuan/v1/chat/completions
هر نام دیگرOpenAIهمهٔ مسیرهای /v1

نام مدل را دقیقاً همان‌طور بنویس که GET /v1/models برمی‌گرداند. مسیریابی به بزرگی و کوچکی حروف حساس نیست، ولی فهرست قیمت هست: نامی با حروف بزرگ (مثل GPT-4o-mini به جای gpt-4o-mini) خطای 402 با کد model_not_priced می‌گیرد. برای عوض کردن سازنده فقط فیلد model را عوض کن؛ کلید و آدرس پایه ثابت می‌مانند. کدام مسیر چه چیزی را پشتیبانی می‌کند در مسیرهای سازگار با OpenAI، Anthropic و Gemini آمده است.

مدل‌ها · ۳

فهرست مدل‌ها از API

GET /v1/models
curl
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.
فیلدهای افزوده‌شدهٔ هر مدل
فیلدنوعمعنی
typestringنوع مدل: chat (چت، Responses‏، Messages و generateContent)، embedding، image، video، transcription، speech، realtime، music، moderation یا rerank. ممکن است مقدار تازه‌ای اضافه شود.
context_windowintegerتوکن ورودی‌ای که مدل می‌پذیرد؛ برای مدل‌های chat و embedding، وقتی معلوم است.
max_output_tokensintegerبیشترین توکن خروجی مدل؛ برای مدل‌های chat، وقتی معلوم است.

فیلدی که معلوم نیست حذف می‌شود و هرگز حدس زده نمی‌شود. فیلدهای قبلی هر مدل (و هر فیلد دیگری که سازنده فرستاده) دست نمی‌خورند. همین سه فیلد روی GET /v1/models/{id} هم هست.

یک مدل در فهرست

json
{
  "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 می‌گیرد.
http
X-1xai-Model-Alias: gemini-2.0-flash -> gemini-2.5-flash