Перейти к основному содержанию
GET
Каталог текстовых моделей
Каталог текстовых моделей: идентификатор, контекстное окно и цены за миллион входных и выходных токенов. Это источник истины — он всегда показывает то, что обслуживается сейчас, поэтому проверяйте модель по нему, а не по списку, зашитому в код.

Пример

Хотите увидеть цены своего тарифа — передайте ключ:
Аутентификация здесь необязательна: без ключа вернутся базовые цены, с ключом — цены вашего тарифа. Запрос без ключа работает вообще без заголовков.

Ответ

200 OK:
cost_context и cost_completion — строки, а не числа. Умножайте цену на число токенов, разделённое на миллион, и приводите результат к строке точно: цена за запрос должна сходиться с usage.cost.total_cost из ответа чата, а не «примерно».

Что попадает в каталог

Только включённые и небесплатные текстовые модели.
Медиа-моделей здесь нет. За моделями генерации изображений, видео, аудио и музыки обращайтесь к GET /api/v1/media/models — см. страницу Медиа-модели.

Модели для оценки решений

Модели эндпоинта POST /api/v1/decisions живут в том же каталоге. У них в capabilities есть значение "decisions", а в cost_context и cost_completion — цены за миллион токенов, по которым идёт списание за вызов. Отберите такую модель через фильтр:
cURL
Идентификатор из выдачи подставляется в поле model запроса как есть — см. страницу Оценка решений.

Модели эмбеддингов

Модели эндпоинта POST /api/v1/embeddings живут в том же каталоге. У них в capabilities есть значение "embeddings". Списание за вызов идёт только за входные токены по цене cost_context — выходные токены у эмбеддингов всегда нулевые. Отберите такую модель через фильтр:
cURL
Идентификатор из выдачи подставляется в поле model запроса как есть — см. страницу Эмбеддинги. Эмбеддинг-модели появляются в каталоге, только когда оператор подключил провайдера эмбеддингов.

Модели ранжирования, синтеза и распознавания речи

Эндпоинты POST /api/v1/rerank, POST /api/v1/audio/speech и POST /api/v1/audio/transcriptions тоже работают с моделями из этого каталога. У каждой группы своё значение в capabilities: "rerank" у ранжирования, "speech" у синтеза речи, "transcription" у распознавания. Отберите группу тем же фильтром:
cURL
Идентификатор из выдачи подставляется в поле model запроса как есть — см. страницы Ранжирование, Синтез речи и Распознавание речи.

Как выбрать модель

Отберите идентификатор по нужному контекстному окну и передайте его прямо в запрос:
cURL
То же на Python:
Python
context_length — это то самое значение, с которым API сверяет длину вашего запроса при предварительной проверке. Если входные токены плюс резерв выхода не помещаются в контекстное окно, придёт 422 content_too_large — API отклонит запрос ещё до обращения к провайдеру.

Ошибки

Другой код возможен только если переданный ключ недействителен. Без ключа запрос проходит всегда.

Что дальше

Запрос чату

Отправить выбранную модель в чат

Медиа-модели

Каталог моделей генерации медиа

Тарификация

Как устроены цены и списания

Баланс

Остаток кошелька по валютам

Авторизации

Authorization
string
header
обязательно

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Ответ

Каталог моделей.

object
string
обязательно
Пример:

"list"

data
object[]
обязательно