Баланс и оплата

Как работает оплата

1. Пополните баланс

   В личном кабинете — карты, СБП, счёт для юрлиц или криптовалюта.

2. Запросы списывают стоимость

   При каждом API-запросе сумма автоматически уходит с баланса. Цена зависит от модели, числа токенов и типа запроса.

3. Смотрите расход в ответе

   Каждый ответ содержит стоимость запроса и актуальный баланс в usage: cost_rub и cost — одно и то же число в рублях.

Пример поля usage:

{
  "choices": [...],
  "usage": {
    "prompt_tokens": 150,
    "completion_tokens": 300,
    "total_tokens": 450,
    "cost": 0.45,
    "cost_rub": 0.45,
    "balance": 4999.55
  }
}

Способы оплаты

Если компании нужен договор или КП, напишите на support@aitunnel.ru. Подробнее — на странице Для юридических лиц.

Сохранённая карта нужна и для авто-пополнения: когда баланс падает ниже порога, сумма списывается сама.

Авто-пополнение

Когда баланс опускается ниже порога, с сохранённой карты автоматически списывается заданная сумма. Так сервисы не останавливаются на нуле.

1. Откройте пополнение

   Панель → Пополнение

2. Сохраните карту

   Если ещё не сохранена — добавьте её после первой оплаты.

3. Включите авто-пополнение

   Задайте порог, сумму пополнения и месячный лимит.

Пример: порог 500 ₽, сумма 2 000 ₽, лимит 10 000 ₽/мес. Баланс упал ниже 500 ₽ — с карты списывается 2 000 ₽. Если за месяц авто-пополнения уже набрали 10 000 ₽, новых не будет.

Проверка баланса

Текущий баланс всегда виден в верхней части панели управления. Через API:

curl https://api.aitunnel.ru/v1/aitunnel/balance \
  -H "Authorization: Bearer sk-aitunnel-xxx"

Ответ:

{
  "balance": 4999.55,
  "budget": 850.0
}

Поле budget есть только если у ключа настроен бюджет. Актуальный баланс также приходит в каждом ответе API — usage.balance. Справка по методу — GET /aitunnel/balance.

Баланс в ответе учитывает все списания на этот момент, включая запрос, который завершился секунду назад. В кабинете цифра обновляется с задержкой до минуты.

Лимит расходов

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

• Чат, Responses, Messages. Откладывается стоимость входа и типичного ответа (около тысячи токенов), а не весь max_tokens — один запрос не занимает баланс целиком. Запрос принимается, если денег хватает на вход и короткий ответ.
• Эмбеддинги, rerank, решения, картинки, озвучка, распознавание. Откладывается оценка стоимости всего запроса.
• Видео и batch. Резервируется худший случай задачи, разница возвращается после завершения — см. видео и Batch.

Если денег не хватает даже на это — ответ 402 с типом insufficient_balance (баланс) или budget_exceeded (бюджет ключа); в error.metadata будут available_rub и required_rub. При балансе 0 ₽ и ниже отклоняется любой запрос, который запускает работу, даже к бесплатной модели. Подробнее — ошибки.

Вывод ограничен балансом

Когда на вход денег хватает, а на полный ответ — нет, запрос не отклоняется. Вывод ограничивается числом токенов, которое вы можете оплатить:

• провайдеру уходит этот предел вместо вашего max_tokens (или максимума модели, если лимит не задан);
• в ответе приходит заголовок X-AITunnel-Output-Capped с этим числом токенов, например X-AITunnel-Output-Capped: 1042;
• если модель дошла до предела, ответ заканчивается как при обычном лимите токенов: finish_reason: "length" в Chat Completions, status: "incomplete" в Responses, stop_reason: "max_tokens" в Messages.

Параллельные запросы

Параллельные запросы делят один баланс. Сумма, отложенная под те, что выполняются прямо сейчас, для новых недоступна — в тексте 402 тогда будет «с учётом выполняющихся запросов». В стриме отложенная сумма растёт вместе с ответом; если деньги закончились по ходу, поток завершается с finish_reason: "length" — см. стриминг.

Одновременно от аккаунта может выполняться до 500 запросов, следующий получит 429.

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

Стоимость считается после ответа

Иногда провайдер не сообщает стоимость вместе с ответом. Ответ вы получаете как обычно, а стоимость мы узнаём у провайдера после:

• в ответе приходит заголовок X-AITunnel-Cost-Pending: true;
• полей usage.cost, usage.cost_rub и usage.balance в таком ответе нет (у бинарных ответов нет заголовков cost-rub и balance);
• списание появляется в истории расходов чуть позже: обычно в течение минуты, изредка до 20 минут. Сумму отдаёт GET /aitunnel/requests/{id} по ID из заголовка X-Request-Id; пока запрос не рассчитан, метод отвечает 404;
• если провайдер так и не назвал стоимость, списывается оценка по ценам каталога. Бесплатным такой запрос не становится.

Так же считается поток, который вы остановили или который оборвался после начала генерации: в самом потоке usage со стоимостью не приходит, списание появляется позже — см. остановка потока.

Уведомления о низком балансе

Порог задаётся в настройках уведомлений. Когда баланс опустится ниже него, придёт письмо.

Ценообразование

Стоимость запроса зависит от:

• Модели — у разных моделей разная цена за токен
• Количества токенов — вход (prompt) и выход (completion) считаются отдельно
• Типа запроса — чат, изображения, аудио и видео тарифицируются по-разному

Актуальные цены — в каталоге моделей.

Возврат средств

Возврат неиспользованных средств возможен в течение 24 часов после пополнения картой, СБП или по счёту. Напишите на support@aitunnel.ru.