Запит балансу та використання

CometAPI надає два способи перевірити баланс акаунта та використання: CometAPI CLI і API сервісу запитів за адресою query.cometapi.com. Якщо ви використовуєте Workspace, перегляньте Керування командою за допомогою CometAPI Workspace, щоб дізнатися про спільні Organization Credits і ролі для виставлення рахунків.

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 key для запитів балансу. Якщо ви хочете обмежити ризик розкриття, вимкніть Unlimited Quota і встановіть найменший додатний кредитний ліміт, дозволений у dashboard.

Параметри запиту

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"

import os
import requests

resp = requests.get(
    "https://query.cometapi.com/user/quota",
    params={"key": os.environ["COMETAPI_KEY"]}
)
data = resp.json()
print(f"Balance: ${data['total_quota']:.2f}")
print(f"Used: ${data['total_used_quota']:.2f}")
print(f"Requests: {data['request_count']}")

const resp = await fetch(
  `https://query.cometapi.com/user/quota?key=${process.env.COMETAPI_KEY}`
);
const data = await resp.json();
console.log(`Balance: $${data.total_quota.toFixed(2)}`);
console.log(`Used: $${data.total_used_quota.toFixed(2)}`);
console.log(`Requests: ${data.request_count}`);

Приклад відповіді

{
  "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
      }
    ]
  }
}

Почніть тут

Швидкий старт з API моделей

Основні посібники з API

Бібліотеки

Помилки

Ціни та виставлення рахунків

Підтримка

Запит балансу та використання

CometAPI CLI

API служби запитів

Параметри запиту

Поля відповіді

Приклади коду

Приклад відповіді

Приклад щоденного розбиття

​CometAPI CLI

​API служби запитів

​Параметри запиту

​Поля відповіді

​Приклади коду

​Приклад відповіді

​Приклад щоденного розбиття

CometAPI CLI

API служби запитів

Параметри запиту

Поля відповіді

Приклади коду

Приклад відповіді

Приклад щоденного розбиття