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

{
  "success": true,
  "remain_balance": 10.5,
  "used_balance": 2.3,
  "unlimited_quota": false
}
  • Запрос остатка и использованной квоты текущего API ключа
  • Мониторинг использования одного токена
  • Поддержка CORS
  • Мониторинг баланса в реальном времени
Получение остатка и использованного баланса текущего API ключа (токена). Этот эндпоинт используется для мониторинга использования одного токена.

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

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

​
Эндпоинты

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

{
  "success": true,
  "remain_balance": 10.5,
  "used_balance": 2.3,
  "unlimited_quota": false
}

​
Ответ

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

​
Применение

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

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

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