Запрос баланса и использования

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-параметр key, а не через Bearer Token.

Используйте отдельный API-ключ для запросов баланса. Если вы хотите ограничить риски, отключите Unlimited Quota и установите минимальный положительный кредитный лимит, который разрешён в панели управления.

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

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"

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 сервиса запросов

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

Поля ответа

Примеры кода

Пример ответа

Пример разбивки по дням