Developer API
Использование и балансы
Читайте текущие балансы, usage, reservations, credit wallets, transactions и entitlements. Пополнение баланса и подписки управляются в личном кабинете, а не через server-side API keys.
#Read-only использование и балансы
Эти endpoints нужны для B2B-сверки: текущие балансы, списания, reservations, credit wallets, transactions и entitlements. Checkout у платежных провайдеров и управление подписками остаются в личном кабинете.
| Метод | Endpoint | Авторизация | Область | Аудитория | Описание |
|---|---|---|---|---|---|
| GET | /billing/credits | API key | billing.read | Разработчики | Возвращает product credit wallets плюс ai_gateway_balance_micros. |
| GET | /billing/transactions | API key | billing.read | Разработчики | Показывает billing transactions с optional product filter. |
| GET | /billing/entitlements | API key | billing.read | Разработчики | Возвращает active subscriptions и period-end cancellation fields. |
| GET | /ai-gateway/balance | API key | ai.gateway | Разработчики | Возвращает balance_micros, pending reservation micros, available balance и USD display values. |
| GET | /ai-gateway/usage | API key | ai.gateway | Разработчики | Показывает AI Gateway usage events с filters по provider, model, status, date и limit. |
| GET | /ai-gateway/reservations | API key | ai.gateway | Разработчики | Показывает active, failed и settled preflight reservations для idempotency и pending-balance debugging. |
/billing/creditsВозвращает product credit wallets плюс ai_gateway_balance_micros.
/billing/transactionsПоказывает billing transactions с optional product filter.
/billing/entitlementsВозвращает active subscriptions и period-end cancellation fields.
/ai-gateway/balanceВозвращает balance_micros, pending reservation micros, available balance и USD display values.
/ai-gateway/usageПоказывает AI Gateway usage events с filters по provider, model, status, date и limit.
/ai-gateway/reservationsПоказывает active, failed и settled preflight reservations для idempotency и pending-balance debugging.
#Credit fields
Video, Ricochet и AI Gateway responses включают credit, token, charge и balance fields, чтобы clients показывали понятный usage state.
credits_deductedremaining_creditsapproval_requiredbudget_exceededinput_tokensoutput_tokensestimated_charge_microscustomer_charge_microsavailable_balance_micros#Idempotency
Idempotency-Key нужно отправлять только для реально реализованных create/hosted-usage flows: video generation, repurpose, AI Gateway chat и Ricochet hosted usage.
Idempotency-Key