Перейти к основному содержанию
GET
/
v1
/
balance
curl --request GET \
  --url 'https://toapis.com/v1/balance' \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "remain_balance": 10.5,
  "used_balance": 2.3,
  "remain_credits": 2100,
  "used_credits": 460,
  "credits_per_usd": 200,
  "unlimited_quota": false
}
  • Запрос остатка и использованной квоты текущего API ключа
  • Мониторинг использования одного токена
  • Поддержка CORS
  • Мониторинг баланса в реальном времени
Получение остатка и использованного баланса текущего API ключа (токена). Этот эндпоинт используется для мониторинга использования одного токена. Также возвращаются поля кредитов с фиксированной конвертацией 1 USD = 200 credits.

​
Авторизация

​
Authorization
string
обязательно
Все эндпоинты требуют аутентификации Bearer TokenПолучить API ключ:Посетите Страницу управления API ключами для получения API ключаДобавьте в заголовок запроса:
Authorization: Bearer YOUR_API_KEY

​
Эндпоинты

GET /v1/balance
GET /balance
Оба эндпоинта имеют одинаковую функциональность. 
curl --request GET \
  --url 'https://toapis.com/v1/balance' \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "remain_balance": 10.5,
  "used_balance": 2.3,
  "remain_credits": 2100,
  "used_credits": 460,
  "credits_per_usd": 200,
  "unlimited_quota": false
}

​
Ответ

​
success
boolean
Успешность запроса
​
message
string
Сообщение об ошибке (только при неудаче)
​
remain_balance
float
Остаток баланса токена (возвращается при успехе). Возвращает -1 когда unlimited_quota равно true
​
used_balance
float
Использованный баланс токена (возвращается при успехе)
​
remain_credits
float
Оставшиеся credits токена (возвращается при успехе). Рассчитывается по курсу 1 USD = 200 credits
​
used_credits
float
Использованные credits токена (возвращается при успехе)
​
credits_per_usd
float
Курс конвертации credits. Сейчас возвращает 200
​
unlimited_quota
boolean
Имеет ли токен безлимитную квоту. true означает безлимитную, false означает ограниченную

​
Применение

  • Мониторинг потребления одного API ключа
  • Отображение текущего баланса токена в приложении
  • Настройка оповещений при низком балансе
Информация о единицах балансаЕдиница измерения баланса зависит от конфигурации системы:
  • USD - Доллары США
  • CNY - Китайские юани
  • Tokens - Количество токенов
Для стабильной интеграции используйте remain_credits и used_credits, если нужны значения в credits. Эти поля всегда используют 1 USD = 200 credits и не зависят от настройки отображения баланса.
Безлимитный токенКогда токен имеет безлимитную квоту:
  • Поле unlimited_quota возвращает true
  • Поле remain_balance возвращает -1
  • Токен не имеет ограничений квоты

​
Частые ошибки

Сообщение об ошибкеПричинаРешение
Нет заголовка AuthorizationЗаголовок Authorization не предоставленДобавьте заголовок Authorization: Bearer sk-xxxxx
Не удалось получить информацию о токенеТокен не существует или был удаленПроверьте правильность ключа токена
Примечание по безопасностиВаш API ключ подобен паролю. Храните его в безопасности и не делитесь с другими. Всегда используйте HTTPS в продакшене.