Баланс
Как получить баланс аккаунта и сумму расходов по API-ключу.
Скачать инструкцию для агента .mdИспользуйте /v1/balance, чтобы получить текущий баланс аккаунта и накопленные расходы. Маршрут принимает тот же API-ключ, которым вы вызываете модели.
Запрос
bash
curl https://api.aigate.shop/v1/balance \ -H "Authorization: Bearer sk-your-api-key"Ответ
json
{ "object": "balance", "currency": "USD", "balance": 12.5, "used": 3.42, "total": 15.92, "balance_quota": 6250000, "used_quota": 1710000, "total_quota": 7960000, "token": { "id": 17, "name": "production", "remaining": 10.0, "used": 1.8, "total": 11.8, "remaining_quota": 5000000, "used_quota": 900000, "total_quota": 5900000, "unlimited_quota": false, "model_limits_enabled": false, "model_limits": {}, "expires_at": 0 }}Поля
| Поле | Что значит |
|---|---|
| balance | Текущий баланс аккаунта в долларах. |
| used | Сколько всего потрачено с аккаунта, в долларах. |
| total | balance + used по аккаунту. |
| balance_quota / used_quota / total_quota | Те же значения во внутренних единицах. |
| token.remaining | Остаток лимита этого API-ключа в долларах. |
| token.used | Сколько потрачено через этот API-ключ, в долларах. |
| token.unlimited_quota | true значит, что ключ тратит общий баланс аккаунта, а не отдельный фиксированный лимит. |
Стоимость одного запроса
Если нужно получить стоимость отдельного запроса только через API, вызовите /v1/balance до и после генерации и посчитайте разницу token.used или used. Обычно удобнее брать token.used, потому что это расходы именно того ключа, который сделал запрос.