Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

CometAPI предоставляет два способа проверить баланс аккаунта и использование: CometAPI CLI и API сервиса запросов по адресу query.cometapi.com.

​
CometAPI CLI

Самый быстрый способ проверить баланс из терминала. Инструкции по установке см. в обзоре CometAPI CLI. 
cometapi balance
Добавьте --source token, чтобы получить сведения по каждому ключу: 
cometapi balance --source token
Все доступные параметры см. в справочнике команд.

​
API сервиса запросов

GET https://query.cometapi.com/user/quota Возвращает баланс на уровне аккаунта, накопленное использование, общее количество запросов и сведения о квотах по каждому ключу. Этот endpoint использует отдельный сервис запросов по адресу query.cometapi.com и проходит аутентификацию через query-параметр key, а не через Bearer Token.
Создайте отдельный API-ключ для запросов баланса и установите для него квоту 0 (разрешение только на запросы). Даже если ключ будет скомпрометирован, его нельзя будет использовать для запросов к моделям.

​
Параметры запроса

ParameterTypeRequiredDescription
keystringYesВаш API-ключ CometAPI
start_datestringNoНачальная дата для ежедневной детализации (формат YYYY-MM-DD)
end_datestringNoКонечная дата для ежедневной детализации (формат YYYY-MM-DD)
Если указаны start_date и end_date, ответ включает поле daily_quota с разбивкой использования по каждому ключу по дням.

​
Поля ответа

FieldTypeDescription
usernamestringИмя пользователя
total_quotanumberТекущий баланс аккаунта (USD)
total_used_quotanumberНакопленное использование (USD)
request_countintegerОбщее количество запросов
keysarrayСведения о квотах по каждому ключу
keys[].namestringИмя API-ключа
keys[].remain_quotanumberОставшаяся квота ключа; -1 означает без ограничений
keys[].used_quotanumberИспользованная квота ключа; -1 означает без ограничений
daily_quotaobjectЕжедневная разбивка использования (только если заданы start_date и end_date)
daily_quota[date]arrayЗаписи использования по каждому ключу для этой даты
daily_quota[date][].token_namestringИмя API-ключа
daily_quota[date][].quota_usednumberИспользование этого ключа в эту дату (USD)
daily_quota[date][].request_countintegerКоличество запросов для этого ключа в эту дату

​
Примеры кода

Запрос баланса аккаунта: 
curl `https://query.cometapi.com/user/quota?key=${process.env.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
      }
    ]
  }
}