Запрос на использование токена (использование токена)
Описание функции
Запросить текущий токен носителя посредством аутентификации Использование квоты: общая предоставленная, использованная, оставшаяся сумма, неограниченная ли, модельный лимит и срок действия.
📮 Конечная точка
GET /api/usage/token- Информация аутентификации должна передаваться в заголовке запроса.
- Возвращается только информация об использовании токена, использованного в текущем запросе.
🔐 Аутентификация
Включите в заголовок запроса для аутентификации ключа API следующее:
Authorization: Bearer $API_KEY- Поддерживает наличие или отсутствие префикса
sk-, сервер будет автоматически совместим - Отсутствующий или неверный заголовок авторизации вернет 401.
💡 Пример запроса
curl -X GET https://api.88api.ai/api/usage/token \
-H "Authorization: Bearer $API_KEY"✅ Пример успешного ответа
{
"code": true,
"message": "ok",
"data": {
"object": "token_usage",
"name": "Default Token",
"total_granted": 1000000,
"total_used": 12345,
"total_available": 987655,
"unlimited_quota": false,
"model_limits": {
"gpt-5.5": true
},
"model_limits_enabled": false,
"expires_at": 0
}
}❗ Пример ответа об ошибке
- Отсутствует заголовок аутентификации:
{
"success": false,
"message": "No Authorization header"
}- Сценарий без носителя:
{
"success": false,
"message": "Invalid Bearer token"
}- Не удалось выполнить поиск токена (например, он недействителен или удален):
{
"success": false,
"message": "token not found"
}🧾 Описание поля (данные)
object: исправлено значениеtoken_usage.name: имя токена.total_granted: общая предоставленная сумма (= использовано + осталось)total_used: использована квота.total_available: доступный остаток балансаunlimited_quota: неограничен ли онmodel_limits: список разрешенных моделей.model_limits_enabled: включить ли квоту модели.expires_at: временная метка Unix срока действия в секундах. Если срок действия не ограничен, возвращается0