Биллинг и статистика

Открыть в Markdown
На этой странице

Баланс в долларах. Пополняешь заранее — запросы списывают с него по фактическим токенам, без подписки и без минимального чека в месяц.

Как списываются деньги#

  1. Перед запросом мы резервируем на балансе сумму по оценке. Если баланса не хватает — ответ 402 insufficient_balance.
  2. После ответа списываем сумму по фактическим токенам из ответа провайдера, остаток резерва сразу возвращается на баланс. Списание не бывает больше резерва.

Из чего складывается резерв#

  • Вход: размер тела запроса в байтах, делённый на 3, плюс 8 192 токенов запаса на служебную часть промпта.
  • Выход: max_tokens (в протоколах OpenAI — max_output_tokens или max_completion_tokens). Если поле не задано, берётся максимум модели — от 32 000 до 128 000 токенов.
  • Сумма считается по ценам модели, и к ней добавляется 20%.

Резерв заведомо больше списания: это запас, а не цена. Но баланс должен его вместить, поэтому на небольшом балансе задавай max_tokens явно. Месячный лимит ключа тоже проверяется по резерву.

Резерв запроса, который оборвался без ответа, возвращается сразу; в редком случае сбоя на нашей стороне — примерно через 45 минут.

Что считается#

  • Вход, выход, чтение кэша и запись в кэш считаются отдельно, каждое по своей цене.
  • Цена чтения кэша у каждой модели своя — единой доли от цены входа нет. Запись в кэш тоже платная, с отдельной ценой для кэша на 5 минут и на час. Цены — на странице цен.
  • Claude Code и Codex кэшируют промпт сами — в долгой сессии большая часть входа идёт по цене чтения кэша.
  • У запроса с токенами есть минимальное списание — $0,000001: очень короткие запросы не уходят в ноль.
  • POST /v1/messages/count_tokens бесплатный.

Ошибки#

  • Запрос отклонён или упал до начала генерации — не платишь, резерв возвращается целиком.
  • Генерация оборвалась на середине — платишь за то, что модель успела сгенерировать, как у официальных API. Если провайдер не успел прислать счётчики токенов, вход и выход считаются по оценке.

Статистика#

В кабинете виден каждый запрос, который дошёл до провайдера:

  • расходы, запросы, токены и ошибки по дням и по моделям;
  • журнал запросов: модель, ключ, протокол, токены входа, выхода и кэша, цена, задержка и время до первого токена, HTTP-статус и код ошибки;
  • фильтры по ключу и модели и выгрузка в CSV или JSON.

Ошибкой в статистике считается только сбой на нашей стороне: ответ 5xx или оборванный стрим. Что значат коды в журнале — в разделе «Ошибки и лимиты».

Тексты промптов и ответов мы не храним — только числа.

Пополнение#

Картой в рублях или криптой — на странице «Оплата». Сумма — любая от $1 до $1000 с точностью до цента. При оплате картой сумма в рублях считается по курсу на момент платежа, а на баланс приходит ровно столько долларов, сколько ты указал.