فهرست مدلها
GET /v1/models — کاتالوگ محدودشده به چیزی که کلید شما میتواند صدا بزند.
GET
https://iranrouter.com/v1/modelsکاتالوگ، محدودشده به آنچه همین کلید میتواند صدا بزند. احراز هویت لازم است، چون فهرست به کلید بستگی دارد.
شناسهٔ مدل در نمونههای این مستندات شکل ِ درخواست را نشان میدهد، نه اینکه آن مدل امروز در دسترس است. مدلهایی که کلید شما امروز میتواند صدا بزند، از هر نوع (گفتوگو، تصویر، embedding، صدا و …)، همین فهرست است؛ مدلی که در آن نیست با 404 و کد model_not_found رد میشود.
curl https://iranrouter.com/v1/models -H "Authorization: Bearer ir-..."
{
"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 هدایت میشود. |
GET
https://iranrouter.com/v1/models/{id}یک مدل، با همان شکل ردیف فهرست. شناسه اسلش دارد، پس مسیر را encode نکنید: GET https://iranrouter.com/v1/models/deepseek/deepseek-v4-flash. مدلی که در فهرست این کلید نیست ۴۰۴ میگیرد.
کاتالوگ عمومی همراه قیمت ریالی و سنجهها در صفحهٔ مدلها.