잔액 조회 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: 토큰 만료 타임스탬프, 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/…)로도 사용 가능;
수치 기준은 기본적으로 토큰 단위로 집계됩니다: 반환되는 값은 현재 토큰의 크레딧과 사용량이며, 전체 계정 기준이 아닙니다;
이 인터페이스는 OpenAI 공식 billing 인터페이스의 필드와 호환되므로, “잔액 표시”를 지원하는 대부분의 서드파티 클라이언트 (예: Cherry Studio, Chatbox)에서 직접 잔액을 표시하는 데 사용할 수 있습니다;
고빈도 폴링은 의미가 없으므로, 분 단위 또는 그보다 낮은 빈도로 조회하는 것을 권장합니다.