API de consultation du solde

4ALL API propose deux interfaces de consultation compatibles OpenAI, permettant de vérifier directement le solde restant et la consommation cumulée à l’aide d’un jeton API, ce qui facilite la mise en place d’alertes de solde ou de tableaux de bord d’utilisation côté métier.

Consulter le quota

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

Exemple de réponse :

{
  "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 : quota total disponible pour ce jeton (utilisé + restant) ;
access_until : horodatage d’expiration du jeton, 0 signifie valable indéfiniment ;
si le jeton est configuré avec un quota illimité, ce champ renverra un grand nombre fixe.

Consulter l’usage consommé

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

Exemple de réponse :

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

total_usage est exprimé en centimes (0,01 dollar US), 123.45 correspond à $1.2345 ;
quota restant = hard_limit_usd − total_usage / 100.

Explications et précautions

Les chemins sans préfixe /v1 pour ces deux interfaces (/dashboard/billing/…) sont également utilisables ;
la métrique est par défaut calculée par jeton : la réponse renvoie le quota et l’usage du jeton actuel, et non de l’ensemble du compte ;
cette interface est compatible au niveau des champs avec l’interface de facturation officielle d’OpenAI, et la plupart des clients tiers prenant en charge l’« affichage du solde » (comme Cherry Studio, Chatbox) peuvent l’utiliser directement pour afficher le solde ;
un sondage à haute fréquence n’a pas d’intérêt ; il est recommandé d’interroger à l’échelle de la minute ou à une fréquence plus basse.