Как считается баланс и расход

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

#Формула

баланс = общий лимит − фактический расход
        = totalCostLimit − currentTotalCost

Общий лимит — это сумма всех ваших пополнений. Фактический расход — сколько уже списано по upstream-токенам (input + output + cache) за всё время. Оба числа берутся из одного места — шлюза — и в реальном времени.

#Что откуда берётся

#Где посмотреть баланс

• Личный кабинет — раздел обзор и баланс: остаток, общий и дневной лимиты, расход за сегодня и за всё время.
• Виджет на главной — быстрая проверка ключа cr_… показывает остаток и статус без входа в кабинет.
• Программно — Usage Query API по read-only токену ro_…: удобно для мониторинга и алертов.

#Как пополнить

1. 1
   Напишите менеджеру

   Пополнение — вручную через Telegram @nukind. Укажите ключ и сумму.

2. 2
   Оплатите

   В рублях или USD. После оплаты владелец поднимает общий лимит вашего ключа на сумму пополнения.

3. 3
   Баланс вырастет сразу

   Общий лимит увеличился → баланс (лимит − расход) тут же стал больше. Ключ продолжает работать без пересоздания.

#Что значит «без общего лимита»

Если у ключа общий лимит равен нулю, это трактуется как безлимитный ключ, а не «ноль денег». В этом случае формула баланса не применяется, и кабинет показывает статус «без общего лимита» вместо остатка — тратить можно без верхней границы.

#Что происходит при исчерпании баланса

Когда фактический расход догоняет общий лимит, баланс становится равен нулю, и шлюз перестаёт выполнять запросы — возвращает ошибку 402 Payment Required. Это не сбой: так система защищает вас от расхода сверх оплаченного.

{
  "type": "error",
  "error": {
    "type": "insufficient_balance",
    "message": "Недостаточно средств на балансе. Пополните счёт."
  }
}