Справочник API/Баланс и расход

Баланс, история вызовов и расход

Запрашивайте баланс аккаунта, историю вызовов, сводку расхода и данные ключа с текущим API-ключом.

Эти эндпоинты выполняют запрос от имени текущего API-ключа — через Bearer или x-api-key. Рабочие API-ключи изолированы по key id: запросы, сделанные ключом A, не видны при запросе с ключом B, даже если оба ключа принадлежат одному аккаунту. История вызовов принимает только page; размер страницы на сервере фиксирован — 20 записей.

На этой страницеexpand_more

Баланс аккаунтаlink

GET/v1/dashboard/balance

Возвращает баланс на уровне аккаунта, которому принадлежит текущий API-ключ. Несколько ключей одного аккаунта используют этот баланс совместно — отдельного баланса у каждого ключа нет. Обычный аккаунт возвращает availableUsd и reservedUsd; ключ заказа на закупку возвращает предоплаченную доступную, зарезервированную и рассчитанную суммы этого заказа с пометкой source: "market_order".

Request Recordslink

GET/v1/requests?page=1

Возвращает историю вызовов текущего API-ключа за последние 90 дней с пагинацией. Размер страницы фиксирован на сервере — 20 записей, изменить его через limit нельзя. Публичные поля: ID запроса, модель, статус, время, токены, стоимость, название API-ключа и замаскированный ключ.

Usage Summarylink

GET/v1/usage

Сводка по текущему API-ключу: число запросов, успешных и неудачных, общая стоимость, входные и выходные токены. Охват совпадает с /v1/requests.

Информация об API-ключеlink

GET/v1/key

Возвращает накопленное использование и скользящее использование за последние 24 часа, 7 и 30 дней, а также текущий лимит ключа и остаток.