ЦАРЬ РОУТЕР

Список моделей

GET/v1/models

Все доступные модели в формате OpenAI, с карточкой каждой модели: контекст, модальности, параметры, цены в рублях. Карточка одной модели с провайдерами - GET /v1/models/{id}, публичный прайс без ключа - GET /v1/models/info.

Модель, которую временно выключили или у которой не осталось ни одного работающего провайдера, из списка пропадает. Запросы к ней в это время получают 503. Как считается итоговая сумма - в «Сколько стоит запрос».

Кэширование ответа. Ответ несёт заголовок ETag. Передайте его в If-None-Match - если список не изменился, придёт 304 Not Modified без тела.

Лимиты. Расходует счётчик справочных запросов аккаунта - общий с GET /v1/models/{id}, GET /v1/key и GET /v1/balance (поле limits.reference_rpm в GET /v1/key). Запросы к моделям этот счётчик не трогают.

Авторизация

ModelsKey
АвторизацияBearer <ключ>

Ключ типа «Вызов моделей»: Authorization: Bearer sk-tsar-ваш-ключ. Ключ «Просмотр баланса» получит 403 insufficient_scope.

Где: header

Заголовки

If-None-Match?string

ETag из прошлого ответа. Если ответ не изменился, придёт 304 Not Modified без тела.

Тело ответа

application/json

application/json

application/json

application/json

curl https://api.tsarrouter.ru/v1/models \  -H "Authorization: Bearer $TSARROUTER_KEY"
{  "object": "list",  "data": [    {      "id": "yandex/yandexgpt-lite-5",      "object": "model",      "created": 1770508800,      "owned_by": "yandex",      "name": "YandexGPT Lite 5",      "type": "text",      "context_length": 32768,      "architecture": {        "input_modalities": [          "text"        ],        "output_modalities": [          "text"        ]      },      "supported_parameters": [        "max_completion_tokens",        "max_tokens",        "parallel_tool_calls",        "response_format",        "stop",        "stream",        "temperature",        "tool_choice",        "tools",        "top_p"      ],      "reasoning": false,      "pricing_rub": {        "unit": "1M tokens",        "input": {          "min": 200,          "max": 210        },        "output": {          "min": 200,          "max": 210        },        "cached_input": {          "min": 200,          "max": 210        }      }    }  ]}