AI API

Остаток счёта и потолок этого ключа

GET/v1/vcpay/balance

Сколько денег на лицевом счёте компании и сколько из них может потратить ключ, которым сделан запрос. Авторизация — тем же ключом, которым вызывают модели.

Цифры считаются так же, как потолок, по которому шлюз пропускает запросы:

  • available_rub = остаток счёта − расход, ещё не списанный со счёта (не меньше нуля);
  • key_budget_rub = меньшее из available_rub и потолка ключа key_limit_rub.

Когда key_budget_rub равен нулю, запросы к моделям отклоняются.

Ответ

200OK
Остаток счёта и бюджет ключа
account_balance_rub
string, (decimal)
*
Остаток лицевого счёта компании, ₽
available_rub
string, (decimal)
*
Сколько можно потратить сейчас: остаток счёта минус расход, ещё не списанный со счёта, ₽. Не бывает меньше нуля
debt_rub
string, (decimal)
Потрачено сверх остатка и ждёт списания, ₽. Ноль — расход уложился в счёт; больше нуля — следующее пополнение сначала закроет эту сумму
По умолчанию:
0
key_budget_rub
string, (decimal)
*
Сколько может потратить этот ключ: меньшее из доступного и потолка ключа, ₽
key_limit_rub
nullablestring, (decimal)
Свой потолок ключа, ₽. null — ключ ограничен только счётом
as_of
string, (date-time)
*
Момент расчёта, UTC
Остаток счёта и потолок этого ключа
curl "https://llm.vcpay.ru/v1/vcpay/balance" \  -H "Authorization: Bearer ВАШ_КЛЮЧ"
Ответ 200
{  "account_balance_rub": "48250.00",  "available_rub": "47312.40",  "debt_rub": "0",  "key_budget_rub": "10000.00",  "key_limit_rub": "10000.00",  "as_of": "2026-10-12T09:30:00Z"}