GET

/v1/balance

Справочник API

Текущий баланс аккаунта и суммарный расход токенов. Нужен ключ; запрос бесплатный.

1Пример запроса

bash

curl https://api.zukko.pro/v1/balance \
  -H "Authorization: Bearer fetch_YOUR_KEY"

json

{
  "balance_cents": 1234,
  "total_input_tokens": 5000000,
  "total_output_tokens": 1200000,
  "total_tokens_used": 6200000
}

Поле	Тип	Описание
`balance_cents`	int	баланс в центах USD, округлён вниз: `1234` = $12.34. Может быть отрицательным
`total_input_tokens`	int	входные токены за всё время
`total_output_tokens`	int	выходные токены за всё время
`total_tokens_used`	int	сумма входных и выходных

Баланс общий для аккаунта: все ключи тратят одни и те же деньги. Счётчики токенов тоже считаются по всему аккаунту и включают расход в веб-чате и Telegram-боте, а не только через API.
Резервирования нет: деньги списываются после ответа модели. Запрос пропускают, если на балансе не меньше $0.01, иначе 402 insufficient_balance. Дорогой запрос, начатый с маленьким остатком, может увести баланс в минус — тогда следующие запросы получат 402 до пополнения.
Сразу после запроса остаток виден и в заголовке X-Fetch-Balance-Cents — он в микродолларах (1 000 000 = $1), подробнее в разделе Оплата и списания.