Ценовые уровни

Используйте один API-ключ для вызова разных ценовых уровней одной модели.

Некоторые модели предлагаются с несколькими ценовыми уровнями. Уровень — это одна и та же модель, продаваемая по разной цене, например более дешевый уровень рядом с уровнем По умолчанию. Один API-ключ используется для всех уровней; вы выбираете уровень по названию модели, а не через отдельный ключ или параметр.

Уровень По умолчанию

Обычное название модели всегда использует уровень По умолчанию. Существующие запросы продолжают работать без изменений, когда модель получает новый уровень.

{ "model": "gpt-image-2" }

Выбор уровня

Добавьте двоеточие и ID уровня к названию модели:

{ "model": "gpt-image-2:<tier>" }

Это работает для текстовых, графических, видео и аудио моделей везде, где запрос указывает модель: в поле model тела JSON, в поле формы model при загрузке аудио и в сегменте модели пути Gemini. В пути Gemini операция остаётся в конце:

POST /v1beta/models/<model>:<tier>:generateContent

Поиск уровней модели

На каждой странице модели переключатель уровней расположен над таблицей цен и отображает цены каждого уровня и ID модели для вызова. На страницах с единственной ценой уровни отображаются в таблице Ценовые уровни вместо этого. Оба элемента отображаются, только если у модели несколько уровней.
Руководство Markdown /models/<page>/llms.txt каждой модели содержит полные цены всех уровней.
GET /v1/models перечисляет <model>:<tier> рядом с <model> для каждой модели, которую ваш ключ может вызывать с несколькими уровнями.

В Playground текстовых моделей элемент выбора уровня переключается между одними и теми же уровнями. Playground моделей изображений, видео и аудио использует уровень «По умолчанию»; другие уровни вызывайте через API.

Расчеты и поведение

Запрос уровня выполняется только в этом уровне и оплачивается по цене этого уровня.
Если уровень не может обработать запрос, запрос завершается с ошибкой. Он никогда не переходит на другой уровень, поэтому он никогда не оплачивается по другой цене.
Ответы и результаты задач указывают обычное название модели.
Ключ, созданный только для одного уровня, может вызывать только этот уровень и больше ничего.

Ошибки

Код	Причина
`20002`	Уровень не существует, не предлагает эту модель или конечная точка не принимает уровни.
`10002`	Ключу не разрешено использовать запрашиваемый уровень.

Формат ответа описан в разделе Ошибки.