ЦАРЬ РОУТЕР

Баланс аккаунта

GET/v1/balance

Текущий баланс аккаунта. Через API баланс видит только ключ «Просмотр баланса»: его можно отдать мониторингу, тратить деньги он не может. В примерах этот ключ лежит в переменной окружения TSARROUTER_BALANCE_KEY - это отдельный ключ, не тот, которым вызывают модели.

Во время потоковых запросов баланс временно меньше на резерв - см. «Резерв средств в потоковых режимах». Ответ не кэшируется (Cache-Control: no-store): каждый запрос возвращает актуальную сумму.

Лимиты. Расходует один счётчик справочных запросов на аккаунт - общий с GET /v1/models, GET /v1/models/{id} и GET /v1/key, по всем ключам аккаунта. Подробнее - в «Лимитах».

Авторизация

BalanceKey
АвторизацияBearer <ключ>

Ключ типа «Просмотр баланса»: Authorization: Bearer sk-tsar-ваш-ключ. Ключ «Вызов моделей» получит 403 insufficient_scope.

Где: header

Тело ответа

application/json

application/json

application/json

application/json

curl https://api.tsarrouter.ru/v1/balance \  -H "Authorization: Bearer $TSARROUTER_BALANCE_KEY"
{  "object": "balance",  "balance_rub": 100,  "currency": "RUB"}