Skip to main content
GET
Запрашивайте расходы за заданный период с помощью API Key. Доступны фильтрация по моделям и группировка по моделям, календарным дням или обоим признакам. Результат агрегируется сразу: создавать задачу и опрашивать её статус не нужно.

Аутентификация

string
обязательно
Используйте тот же API Key, что и для вызова моделей, с аутентификацией Bearer Token. Получить ключ можно на странице управления API Key.
Запрос доступен при нулевом балансе. Баланс не проверяется, но проверяются статус и срок действия API Key, список разрешённых IP и статус аккаунта.

Эндпоинты

Оба эндпоинта имеют одинаковые функции и поддерживают CORS. Храните API Key безопасно и не раскрывайте его в публичном коде фронтенда.

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

Все параметры передаются в строке запроса URL.
integer | string
Время начала включается в период. Принимается Unix timestamp в секундах или строка RFC3339 с часовым поясом, например 2026-09-01T00:00:00+08:00.По умолчанию — за 24 часа до end. Timestamp задаётся в секундах, не в миллисекундах.
integer | string
Время окончания не включается. Формат тот же, что у start; по умолчанию — текущее время.Должно быть позже start; end - start не может превышать 31 день.
string
Название модели. Если не указано, учитываются все модели. Несколько моделей разделяются запятыми; максимум 50.Точное совпадение без учёта регистра. Подстановочные знаки не поддерживаются.Пример: gpt-5.6-luna,sora-2
string
по умолчанию:"none"
Группировка:
  • none: только итог, items — пустой массив
  • model: по моделям
  • date: по календарным дням
  • model,date: по моделям и календарным дням
string
по умолчанию:"Asia/Shanghai"
Часовой пояс IANA. По умолчанию Asia/Shanghai.Влияет только на границы календарных дней, когда group_by содержит date, и не меняет моменты начала и окончания. Времена RFC3339 интерпретируются с указанным в них часовым поясом.
string
по умолчанию:"key"
Область статистики:
  • key: только текущий API Key (по умолчанию)
  • account: все API Key аккаунта, которому принадлежит текущий ключ
Период — [start, end): начало включается, окончание исключается. Одинаковое значение end предыдущего запроса и start следующего исключает двойной учёт границы.При ручном составлении URL кодируйте + в RFC3339 как %2B. cURL --data-urlencode, Python params и JavaScript URLSearchParams в примерах делают это автоматически.

Примеры запросов

Расходы текущего API Key за последние 24 часа

Без параметров строки запроса используются период, область и группировка по умолчанию.

Ежедневные расходы всего аккаунта по выбранным моделям

Запрос расходов с 11 по 18 сентября 2026 года по пекинскому времени, не включая 18 сентября.

Группировка по моделям и календарным дням

При этой группировке каждый элемент items содержит и model, и date.

Поля ответа

boolean
Успешность запроса: true при успехе, false при ошибке запроса использования.
object
При успехе возвращает область запроса, итог и сгруппированные данные.
data.total и data.items[] используют следующие общие статистические поля:
object
При ошибке запроса использования содержит code, message и type; type равен usage_query_error. Ошибки аутентификации 401 / 403 возвращает слой аутентификации.

Лимиты и кеш

  • Не более 60 запросов в минуту на API Key; также действуют глобальные лимиты API
  • Результаты с одинаковыми параметрами кешируются на 60 секунд; заголовок X-Usage-Cachehit или miss
  • Расходы обычно доступны в течение 1 секунды, но данные за последнюю минуту могут быть неполными; возможна задержка кеша
  • Рекомендуется интервал не менее 1 минуты; не используйте эндпоинт как уведомление о списаниях в реальном времени

Правила учёта

  • Используются записи успешно оплаченных вызовов, как в панели данных на сайте
  • Неуспешные вызовы и возвраты после сбоя задачи исключены; вычитать их вручную не нужно. При частичном успехе пакета изображений оплачиваются фактически выданные изображения
  • Расходы относятся ко времени проведения платежа. Асинхронные задачи изображений и видео учитываются при завершении, не при отправке; при переходе через полночь — в день завершения
  • API Key, созданный заново после удаления, является новым ключом. Его запрос scope=key не включает историю старого ключа
  • Ручные корректировки баланса не являются расходами вызовов и исключаются
  • Доступны данные после 27 апреля 2026 года

Обработка ошибок

Ответ 503 usage_unavailable не содержит сумм. Это означает недоступность запроса, а не нулевые расходы. Не заменяйте ошибку нулевой суммой и не перезаписывайте предыдущий успешный результат.

Отличия от других эндпоинтов

Для оставшегося лимита используйте запрос баланса токена или запрос баланса пользователя.