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-ключ для запросов баланса и установите для него квоту 0 (разрешение только на запросы). Даже если ключ утечёт, его нельзя будет использовать для запросов к моделям.
Параметры запроса
| Parameter | Type | Required | Description |
|---|
key | string | Yes | Ваш API-ключ CometAPI |
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-ключа |
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-ключа |
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
}
]
}
}
