API запроса баланса

4ALL API предоставляет два совместимых с OpenAI интерфейса для запросов, с помощью API-токена можно напрямую проверить оставшийся лимит и накопленный расход, что удобно для настройки оповещений о балансе или панели потребления на стороне бизнеса.

Запрос лимита

curl https://api.4allapi.com/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer $AIPROXY_KEY"

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

{
  "object": "billing_subscription",
  "has_payment_method": true,
  "soft_limit_usd": 25.0,
  "hard_limit_usd": 25.0,
  "system_hard_limit_usd": 25.0,
  "access_until": 0
}

hard_limit_usd: общий лимит, доступный для этого токена (использовано + осталось);
access_until: timestamp истечения срока действия токена, 0 означает бессрочную действительность;
Если для токена установлен неограниченный лимит, это поле вернёт фиксированно большое число.

Запрос использованного объёма

curl https://api.4allapi.com/v1/dashboard/billing/usage \
  -H "Authorization: Bearer $AIPROXY_KEY"

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

{
  "object": "list",
  "total_usage": 123.45
}

Единица total_usage — центы (0.01 доллара США), 123.45 = $1.2345;
Остаток лимита = hard_limit_usd − total_usage / 100.

Примечания и предостережения

Пути без префикса /v1 (/dashboard/billing/…) также доступны;
По умолчанию числовые значения считаются по токену: возвращаются лимит и использование текущего токена, а не всего аккаунта;
Этот интерфейс совместим с полями официального billing-интерфейса OpenAI, и большинство сторонних клиентов, поддерживающих “отображение баланса” (например, Cherry Studio, Chatbox), могут напрямую использовать его для показа баланса;
Частый опрос не имеет смысла, рекомендуется запрашивать с интервалом в минуту или реже.