Перейти к содержимому
Зарегистрироваться бесплатно
API Reference

Как проверить квоту API Key

Узнайте использованную и оставшуюся квоту одного BetterToken API Key через API с авторизацией Bearer. Переведите единицы квоты в сумму с учётом валюты и коэффициента.

Используйте GET https://bettertoken.ai/api/usage/token/, чтобы узнать использованную и оставшуюся квоту одного BetterToken API Key.

Отправка запроса

Используйте тот же BetterToken API Key с префиксом sk-..., с которым вызываете модели. Перед запуском команды задайте его в локальной переменной окружения BETTERTOKEN_API_KEY.

Передайте Authorization: Bearer <API_KEY>. У запроса нет параметров и тела. Сохраните слеш в конце URL; полный URL не содержит /v1.

Окно терминала
curl -sS 'https://bettertoken.ai/api/usage/token/' \
-H "Authorization: Bearer ${BETTERTOKEN_API_KEY}"

Успешный ответ

code: true означает, что запрос выполнен успешно. Ниже приведён фрагмент ответа с демонстрационными значениями.

{
"code": true,
"message": "ok",
"data": {
"object": "token_usage",
"name": "example-key",
"total_granted": 1000000,
"total_used": 250000,
"total_available": 750000,
"unlimited_quota": false,
"quota_currency": "USD"
}
}

Поля квоты

ПолеЗначение
data.total_availableОставшаяся квота этого Key во внутренних единицах.
data.total_usedСуммарная использованная квота этого Key в тех же единицах.
data.total_grantedСумма использованной и оставшейся квоты в тех же единицах.
data.quota_currencyВалюта квоты, например USD.
data.unlimited_quotaЕсли значение равно true, у этого Key нет отдельного лимита квоты. Расходы по-прежнему ограничены балансом кошелька.

Пересчёт в денежную сумму

Получите data.quota_per_unit из ответа на GET https://bettertoken.ai/api/status. Разделите квоту на этот коэффициент, чтобы получить сумму в валюте data.quota_currency.

Оставшаяся сумма = data.total_available / data.quota_per_unit

Например, при коэффициенте 500000 значения из примера дают 750000 / 500000 = 1.50 USD. Использованную квоту пересчитывайте так же.

Баланс кошелька аккаунта можно посмотреть в BetterToken Workspace. Этот интерфейс возвращает только квоту API Key, переданного в запросе.

Последние записи запросов этого Key доступны через API журналов запросов.