Перейти до основного вмісту

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 parameter 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
      }
    ]
  }
}