RouterAPI Docs

Выбор варианта модели

Документация RouterAPI помогает быстро понять, как работать с публичным API, кабинетом, RouterAPI Gateway и мультимодальными сценариями.

Публичная документация

Что выбирает клиент

Без дополнительных параметров RouterAPI сам выбирает доступный вариант модели. В каталоге и на странице модели показывается опорная цена из GET /api/v1/models — та же ставка, по которой идёт списание, если в ответе нет usage.cost.

Как закрепить вариант на один запрос

На один запрос можно передать один tag. Сохранённой настройки в кабинете нет.

Как передать

В теле POST /api/v1/chat/completions, /responses или /messages:

"provider": { "only": ["deepinfra"] }

Либо в строке модели: author/model@provider=deepinfra. Если tag указан и в строке, и в теле, и они разные — ответ 400.

only принимает один tag. order, ignore, country и несколько tag шлюз не принимает.

Поле provider принимается только на этих трёх путях. На остальных путях ответ 400.

Цена при закреплении

Если вы передали provider.only, списание считается по выбранному варианту. Если цена пришла в usage.cost, RouterAPI использует её как итоговую стоимость в рублях. Если usage.cost нет, применяется каталожная цена выбранного варианта.

Если вариант недоступен

Закрепление не делает fallback на другой tag. Если выбранный tag недоступен, запрос завершается ошибкой; повторите без provider.only или выберите другой tag.

Квантизация

Один и тот же model id может иметь разные квантизации. Это влияет на скорость, качество и цену. Если квантизация важна, закрепляйте конкретный tag.

usage.cost

В ответах и биллинге RouterAPI usage.cost трактуется как рублёвая сумма списания. Для потоковых ответов стоимость фиксируется после завершения потока.

Нужен следующий раздел?

Откройте обзор, dashboard, мультимодальность или технические сценарии API.