docs
Деньги

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

Markdown

Как Ailoot считает деньги: резерв перед запросом, одно списание после и баланс, который никогда не уходит в минус.

Коротко

  • Резерв — перед отправкой нового текстового запроса Ailoot резервирует оценку входа и типичного ответа по принятым условиям запроса. Для картинок, видео и звука на выходе сохраняется полный резерв стоимости результата.
  • Списание — одно, по фактическому расходу из usage. Остаток резерва возвращается сразу.
  • Если денег не хватает даже на минимальный резерв — запрос не уходит к модели, вы получаете ошибку 402 с понятным текстом. Ничего не списывается.
Полное руководство

Коротко

  • Цена — в долларах за 1 млн токенов входа и выхода (или за единицу: картинку, секунду видео, символы). Цены каждой модели — в каталоге.
  • Резерв — перед отправкой нового текстового запроса Ailoot резервирует оценку входа и типичного ответа по принятым условиям запроса. Для картинок, видео и звука на выходе сохраняется полный резерв стоимости результата.
  • Меньший лимит вместо отказа — если рассчитанный резерв не помещается в доступный баланс или лимит ключа, уменьшить лимит ответа можно только для точной модели и метода, которые его соблюдают, и только до оплачиваемого объёма не ниже применимого минимума. У каких моделей это работает — ниже.
  • Списание — одно, по фактическому расходу из usage. Остаток резерва возвращается сразу.
  • Если ответ дороже резерва — разница берётся из свободного баланса, не занятого другими резервами. Списание никогда не превышает ваш баланс: баланс не уходит в минус.
  • Если денег не хватает даже на минимальный резерв — запрос не уходит к модели, вы получаете ошибку 402 с понятным текстом. Ничего не списывается.
  • Сбой без результата не оплачивается. Если связь оборвалась, проверьте запрос по Request ID в истории кабинета, прежде чем отправлять его снова.

Как считается резерв

  • Вход резервируется по оценке размера запроса и поддерживаемых вложений, а не по уже известному фактическому расходу. Для новых текстовых запросов используется оценка тела и вложений по их типу. Расчёт «4 токена на байт, но не меньше 4096 токенов» относится к ранее принятым резервам старой версии и не описывает новые текстовые резервы. Если вложение передано ссылкой (fileData) или включены встроенные инструменты, для поддерживаемых текстовых запросов учитывается отдельная оценка вложений и работы инструментов; сам факт их наличия не означает резерв всего входного окна. Для прежних резервов сохраняются принятые условия, а для медиа на выходе — расчёт полного результата.
  • Выход для резерва нового текстового запроса оценивается по типичной длине ответа и принятым условиям. Запрошенный лимит задаётся через max_tokens (max_output_tokens в Responses). Запрошенный лимит не равен автоматически числу токенов, по которому рассчитан резерв, и не гарантирует фактическую длину ответа у модели без надёжного ограничения. Исходное значение 4096 применяется только к соответствующим маршрутам; конкретное правило зависит от модели и метода.
  • Цена для новых текстовых резервов с учётом условий данного запроса учитывает: стандартный или приоритетный режим и достижимые входной оценкой ценовые ступени. Внутри выбранных условий расчёт остаётся консервативным; режим flex не уменьшает резерв. Для приоритетного запроса резерв может учитывать наиболее дорогой применимый режим, включая priority, flex или fast. Ранее принятые резервы без этих условий сохраняют исходный расчёт по максимальным ставкам.
  • Уменьшение лимита — когда рассчитанный резерв не помещается, а точная модель и метод позволяют ограничить ответ: доступных средств должно хватить на оценку входа и минимальный объём выхода. Уменьшенный лимит не опускается ниже 256 токенов (1025 — с размышлениями в формате Anthropic). Модель получает уже уменьшенный лимит.

Пример расчёта

Модель claude-sonnet-5-5: вход $2, выход $10 за 1 млн токенов. Вы отправили 20 000 токенов, модель ответила 1 200 токенами.

ШагРасчётСумма
Фактический вход20 000 × $2 / 1 000 000$0.0400
Фактический ответ1 200 × $10 / 1 000 000$0.0120
Списаноодно списание по фактическому расходу$0.0520

В приведённом арифметическом примере фактическая стоимость равна $0.0520. Показанное списание предполагает, что принятый резерв и доступный свободный баланс покрывают эту стоимость. Величина резерва здесь не вычисляется: для нового текстового запроса она определяется отдельно по оценке входа и типичного ответа и может быть больше или меньше фактической стоимости. Неиспользованный резерв освобождается; ограничение списания приведено в формуле ниже.

Фактическое списание = min(полная фактическая стоимость, принятый резерв + свободный незарезервированный баланс). Другие открытые резервы остаются защищены; поэтому общий баланс не обязательно станет нулевым. Баланс не уходит в минус. Если фактическая стоимость выше принятого резерва и свободного незарезервированного баланса, непокрытая разница остаётся убытком Ailoot: она не становится вашим долгом и не взыскивается позднее.

Отключение клиента

Закрытие соединения, таймаут вашего приложения или отказ читать уже готовый ответ не отменяют запрос автоматически: готовый ответ модели оплачивается один раз. Если результат не доставлен по вине Ailoot, деньги возвращаются. Если связь оборвалась, проверьте запрос по Request ID в истории кабинета, прежде чем отправлять его снова.

Почему иногда нужен больший баланс

  • Для новых текстовых запросов резерв ответа рассчитывается по типичной длине, с учётом заданного max_tokens и условий точной модели. Это оценка резерва, а не гарантия фактической длины или стоимости ответа.
  • У моделей без надёжного лимита фактического ответа оценка резерва не превращается в ограничение длины. Для новых текстовых запросов она не заменяется автоматически стоимостью самого длинного ответа. Ранее принятые резервы сохраняют свои исходные условия.
  • Картинки на входе добавляют к резерву оценку их стоимости.
  • Агенты (Claude Code, Codex CLI, Cline) шлют большой контекст на каждом шаге: один шаг может резервировать десятки центов. Держите на балансе хотя бы несколько долларов.
  • Совет: задавайте разумный max_tokens — это уменьшает резерв у моделей, где длину ответа можно ограничить.

Кэш промптов

У моделей с кэшированием отдельные цены на запись в кэш и чтение из кэша. Чтение обычно в несколько раз дешевле обычного входа. Цены видны в карточке модели в каталоге.

Ошибка 402

Если свободного баланса не хватает даже на минимальный резерв, Ailoot не отправляет запрос и отвечает 402 с кодом insufficient_balance. Если исчерпан общий лимит трат ключа — код api_key_quota_exhausted. Если на аккаунте есть долг по оспоренному платежу — код payment_disputed: новые запросы приостановлены до его погашения.

402 Payment Required
{
  "error": {
    "code": "insufficient_balance",
    "reason": "insufficient_balance",
    "type": "insufficient_quota",
    "param": null,
    "message": "Your balance is too low to start this request. … Request ID: 5c0e7a1d-….",
    "request_id": "5c0e7a1d-…"
  }
}

Где смотреть расходы

История запросов и списаний — в кабинете на ailoot.ai. Для каждого запроса видно модель, токены и сумму.

Остались вопросы? Пришлите Request ID и описание — поможем разобраться.Написать в поддержку