Токены и стоимость
Поля потребления, кэшированные токены, стоимость в рублях, точность значений и расчёт по завершении запроса.
Потребление
prompt_tokens / input_tokensintegerChat / Responses- Общее число входных токенов, включая кэшированные, если модель сообщает их в составе входа.
completion_tokens / output_tokensintegerChat / Responses- Общее число выходных токенов. Рассуждения обычно входят в это число.
total_tokensintegerЕсли доступно- Суммарное потребление токенов.
prompt_tokens_details.cached_tokens / input_tokens_details.cached_tokensintegerЕсли доступно- Часть входных токенов, прочитанная из кэша. Не добавляйте к общему входу повторно.
completion_tokens_details.reasoning_tokens / output_tokens_details.reasoning_tokensintegerЕсли доступно- Часть выхода, использованная для рассуждений.
usage.cost_rubdecimal stringЕсли расчёт завершён- Итоговая стоимость запроса в рублях после расчёта, с 12 знаками после запятой.
{
"usage": {
"input_tokens": 1000,
"input_tokens_details": {
"cached_tokens": 800
},
"output_tokens": 120,
"output_tokens_details": {
"reasoning_tokens": 40
},
"total_tokens": 1120,
"cost_rub": "0.123456789012"
}
}Когда появляется стоимость
В обычном JSON — в usage.cost_rub. В Chat SSE — в завершающем событии со статистикой; в Responses — в response.usage.cost_rub итогового события. Это сумма за весь запрос, а не цена одного токена или фрагмента.
При отсутствии подтверждённого расчёта поле может отсутствовать. Проверяйте состояние в журнале личного кабинета. Не трактуйте отсутствие поля как нулевую стоимость.
Синтез речи и скачивание видео возвращают файл, поэтому JSON-поля стоимости в теле нет. Создание видео асинхронно: стоимость отражается в журнале после расчёта завершённой задачи. Скачивание не является новой генерацией.
Точность и единицы
Сохраняйте cost_rub строкой и используйте десятичную арифметику. Преобразование в JavaScript Number и раннее округление до копеек может дать расхождение при суммировании множества запросов.
Цена определяется тарифом на момент запроса. Кэш и рассуждения учитываются согласно модели и тарифу. Для изображений, звука и видео могут использоваться другие единицы: изображения, секунды аудио и видео, символы. Подробности доступны в карточке модели и журнале.
