Стоимость и учёт токенов

Актуальные тарифы доступны в личном кабинете API возвращает счётчики использования, а не окончательную сумму списания в рублях

Стоимость через OpenRouter

Итоговое списание рассчитывается по фактической стоимости запроса у провайдера, курсу расчёта и коэффициенту группы аккаунта

списание_в_рублях = стоимость_провайдера_в_USD × курс_расчёта × коэффициент_группы

Учитывается округление до единицы внутреннего баланса. Курс и коэффициент смотрите в данных расчёта и журнале расходов

Цены в каталоге помогают оценить расходы. У одной модели несколько провайдеров, итоговая стоимость зависит от того, кто выполнил запрос, и от использованных компонентов: токенов, кеша, изображений, аудио, видео и инструментов

При выборе провайдера учитывайте его тариф. Смена исполнителя может изменить стоимость

Резерв и списание

Перед выполнением сервис может зарезервировать предварительную сумму. Итоговый расчёт должен учитывать фактическую стоимость и возврат остатка, статус завершения сам по себе не подтверждает освобождение резерва

Резерв не равен окончательному расходу. Для медиа и асинхронных заданий журнал может содержать отдельный расход на резервирование и возврат остатка после расчёта. Сопоставляйте связанные проводки задания и итоговый баланс

Для Batch проверяйте billing_status, reserved_quota и charged_quota отдельно от статуса выполнения. При reconciliation_required не считайте резерв освобождённым, сохраняйте ID задания, сумму резерва и время для сверки с журналом и поддержкой

Для аудиозаданий возможен reconciliation.billing_state: "manual_reconciliation", в том числе при status: "FAILURE". При cost_confirmed: false стоимость ещё не подтверждена, next_lookup_at: null означает, что следующая проверка не назначена, срок автоматического возврата по этим полям определить нельзя

Если в журнале есть task_id, проверьте задание через GET /v1/tasks/{task_id} с ключом того же аккаунта. Сохраните ID задания и запроса, сумму резерва и связанные проводки для сверки с поддержкой. У внутреннего задания и внешнего аудиозапроса ID могут различаться, совпадение времени и модели не доказывает их связь

Не создавайте новое задание ради возврата прежнего резерва. Проверяйте тот же ID, освобождение резерва подтверждайте полями расчёта и связанными проводками

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

Текстовые модели

Если тариф задан за миллион токенов, базовый расчёт имеет вид

стоимость = входные_токены × цена_ввода / 1_000_000
          + выходные_токены × цена_вывода / 1_000_000

Если у модели отдельные тарифы для кеша, инструментов или модальностей, учитывайте соответствующие категории отдельно Не добавляйте кешированные токены повторно к сумме, в которую они уже входят

Счётчики

Состав подробной разбивки зависит от модели Счётчики кеша и рассуждений могут отсутствовать История диалога, системная инструкция и описания инструментов входят в обрабатываемый контекст

Рассуждения

Выходные токены могут включать рассуждения, которых нет в итоговом тексте Пустой ответ при исчерпанном бюджете также может иметь ненулевой расход Не оценивайте стоимость по числу символов видимого ответа

Лимиты

max_tokens и max_output_tokens не гарантируют предельную стоимость Реальное соблюдение лимита зависит от модели и метода Используйте фактический расход и ограничения приложения

Изображения, аудио и видео

Единицы тарификации определяются конкретной моделью Это могут быть токены, изображения, символы, секунды или другие единицы Не переносите тариф одной модели на остальные

Сверка

В личном кабинете сверяйте расходы с итоговыми проводками. Строка «Стоимость» для аудио может продолжать показывать исходный резерв после возврата остатка Суммарный API-счётчик total_usage не трактуйте как рубли или расход за произвольный период

Баланс, журнал запросов