فهرست مدل‌ها

GET /v1/models — کاتالوگ محدودشده به چیزی که کلید شما می‌تواند صدا بزند.

GEThttps://iranrouter.com/v1/models

کاتالوگ، محدودشده به آنچه همین کلید می‌تواند صدا بزند. احراز هویت لازم است، چون فهرست به کلید بستگی دارد.

شناسهٔ مدل در نمونه‌های این مستندات شکل ِ درخواست را نشان می‌دهد، نه اینکه آن مدل امروز در دسترس است. مدل‌هایی که کلید شما امروز می‌تواند صدا بزند، از هر نوع (گفت‌وگو، تصویر، embedding، صدا و …)، همین فهرست است؛ مدلی که در آن نیست با 404 و کد model_not_found رد می‌شود.
Shell
curl https://iranrouter.com/v1/models -H "Authorization: Bearer ir-..."
JSON
{
  "object": "list",
  "data": [
    {
      "id": "deepseek/deepseek-v4-flash",
      "object": "model",
      "display_name": "DeepSeek V4 Flash",
      "author": { "slug": "deepseek", "name": "DeepSeek" },
      "architecture": { "input_modalities": ["text"], "output_modalities": ["text"] },
      "kind": "chat",
      "endpoint": "/v1/chat/completions",
      "context_window": 128000,
      "max_output_tokens": 16384,
      "capabilities": { "tools": true, "vision": false, "json_schema": true },
      "created": 1721260800,
      "top_provider": { "context_length": 128000, "max_completion_tokens": 16384 },
      "supported_parameters": ["max_tokens", "temperature", "tools", "tool_choice", "response_format"],
      "pricing": {
        "currency": "IRR",
        "input_rial_per_mtok": 1500000,
        "output_rial_per_mtok": 6000000,
        "cached_input_rial_per_mtok": 150000,
        "conditional": [
          { "utc_start": 100, "utc_end": 900, "pricing": { "input_rial_per_mtok": 3000000, "output_rial_per_mtok": 12000000 } }
        ]
      },
      "billed_from": "plan"
    }
  ]
}
فیلدمعنی
idهمان رشته‌ای که در فیلد model می‌فرستید.
architectureآنچه مدل می‌گیرد و می‌سازد: text، image، audio، video، file، embeddings، transcription، speech، rerank.
kindنوع مدل: chat، embedding، rerank، moderation، image، video، speech، transcription، realtime، ocr، music، detector، classifier، judgment یا generic.
endpointمسیری که این مدل روی آن جواب می‌دهد. یک مدل embedding را روی chat/completions صدا نزنید.
context_windowسقف توکن ورودی + خروجی.
capabilitiesقابلیت‌های اعلام‌شده.
supported_parametersنام پارامترهایی که این مدل می‌پذیرد.
pricingهمهٔ قیمت‌هایی که هزینهٔ یک درخواست با آن‌ها حساب می‌شود، به ریال؛ همان‌هایی که صفحهٔ مدل نشان می‌دهد. نرخ ورودی و خروجی در هر میلیون توکن، و اگر مدل داشته باشد نرخ کش (cached_input، cache_write، cache_write_1h)، استدلال (internal_reasoning)، تصویر و صدا، همه با پسوند _rial_per_mtok؛ و قیمت هر درخواست، هر جست‌وجو، هر تصویر یا هر صفحه با پسوند _rial_per_unit. نرخی که مدل ندارد در پاسخ نمی‌آید.
pricing.followsدسته‌ای از توکن که مدل دارد ولی نرخ جدا برایش نیست، و نرخی که با آن حساب می‌شود: input یا output.
pricing.conditionalقیمت‌هایی که تا وقتی شرطشان برقرار است جای قیمت‌های بالا را می‌گیرند: prompt با دست‌کم min_prompt_tokens توکن، یا یک بازهٔ ساعت به وقت UTC (utc_start و utc_end به شکل HHMM، و utc_days نام روزهای هفته). برای مدلی که بازهٔ ساعتی دارد، قیمت اصلی قیمت بیرون از آن بازه است.
billed_from«plan» از سهمیهٔ پلن، «credit» از کیف پول.
deprecated / sunset_at / successorفقط روی مدل منسوخ: تا sunset_at کار می‌کند، بعد از آن به successor هدایت می‌شود.
GEThttps://iranrouter.com/v1/models/{id}

یک مدل، با همان شکل ردیف فهرست. شناسه اسلش دارد، پس مسیر را encode نکنید: GET https://iranrouter.com/v1/models/deepseek/deepseek-v4-flash. مدلی که در فهرست این کلید نیست ۴۰۴ می‌گیرد.

کاتالوگ عمومی همراه قیمت ریالی و سنجه‌ها در صفحهٔ مدل‌ها.