CometAPI надає два способи перевірити баланс акаунта та використання: CometAPI CLI і API сервісу запитів за адресою query.cometapi.com.
Найшвидший спосіб перевірити баланс із термінала. Інструкції зі встановлення див. в огляді CometAPI CLI.
Додайте --source token, щоб отримати деталі для кожного ключа:
cometapi balance --source token
API сервісу запитів
GET https://query.cometapi.com/user/quota
Повертає баланс на рівні акаунта, сукупне використання, загальну кількість запитів і деталі квот для кожного ключа. Цей endpoint використовує окремий сервіс запитів за адресою query.cometapi.com і автентифікується через query-параметр key, а не через Bearer Token.
Створіть окремий API key для запитів балансу та встановіть для нього квоту 0 (дозвіл лише на запити). Навіть якщо ключ буде скомпрометований, його не можна буде використовувати для запитів до моделей.
Параметри запиту
| Parameter | Type | Required | Description |
|---|
key | string | Yes | Ваш CometAPI API key |
start_date | string | No | Початкова дата для щоденної деталізації (формат YYYY-MM-DD) |
end_date | string | No | Кінцева дата для щоденної деталізації (формат YYYY-MM-DD) |
start_date і end_date, відповідь містить поле daily_quota із розбивкою використання по днях для кожного ключа.
Поля відповіді
| Field | Type | Description |
|---|
username | string | Ім’я користувача |
total_quota | number | Поточний баланс акаунта (USD) |
total_used_quota | number | Сукупне використання (USD) |
request_count | integer | Загальна кількість запитів |
keys | array | Деталі квот для кожного ключа |
keys[].name | string | Назва API key |
keys[].remain_quota | number | Залишок квоти ключа; -1 означає безліміт |
keys[].used_quota | number | Використана квота ключа; -1 означає безліміт |
daily_quota | object | Щоденна розбивка використання (лише коли вказано start_date і end_date) |
daily_quota[date] | array | Записи використання для кожного ключа на цю дату |
daily_quota[date][].token_name | string | Назва API key |
daily_quota[date][].quota_used | number | Використання для цього ключа на цю дату (USD) |
daily_quota[date][].request_count | integer | Кількість запитів для цього ключа на цю дату |
Приклади коду
Запит балансу акаунта:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"
Приклад відповіді
{
"username": "example_user",
"total_quota": 2105.23,
"total_used_quota": 21.07,
"request_count": 1221,
"keys": [
{
"name": "my-key",
"remain_quota": 8.94,
"used_quota": 2.10
}
]
}
Приклад щоденної розбивки
Запит щоденного використання для діапазону дат:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
daily_quota:
{
"username": "example_user",
"total_quota": 2105.23,
"total_used_quota": 21.07,
"request_count": 1221,
"daily_quota": {
"2026-04-13T00:00:00Z": [
{
"token_name": "my-key",
"quota_used": 4.27,
"request_count": 59
}
],
"2026-04-14T00:00:00Z": [
{
"token_name": "my-key",
"quota_used": 0.57,
"request_count": 36
}
]
}
}
