Suivi des coûts de l'API IA : surveillez les dépenses via les en-têtes
Vous pouvez créer un suivi des coûts de l'API IA en une cinquantaine de lignes, car chaque réponse indique déjà votre solde restant. Ce guide montre comment journaliser les dépenses par requête, lire les endpoints de solde et déclencher une alerte avant l'épuisement du crédit.


Points clés
- Chaque réponse contient un en-tête X-Balance-USD indiquant votre crédit restant.
- GET /v1/balance et l'endpoint credit_grants retournent le solde à la demande.
- Le coût par appel est (entrée x 0,15 + sortie x 0,50) / 1 000 000 de dollars.
- Enregistrez au format CSV, puis alertez lorsque le solde passe sous un seuil.
D'où viennent les chiffres
Le crédit prépayé simplifie le suivi des coûts, car le fournisseur conserve déjà un total en cours. Vous l'obtenez à trois endroits :
- L'en-tête de réponse
X-Balance-USDsur les appels API, indiquant ce qui reste après la requête. GET /v1/balance, une simple consultation du solde.GET /v1/dashboard/billing/credit_grants, la route de style OpenAI que les outils tels que les tableaux de bord et les wrappers savent déjà appeler.
À côté de cela, chaque réponse renvoie un objet usage avec les compteurs de tokens de prompt et de réponse. Combinez les tokens avec les prix (0,15 $ par 1 M de tokens d'entrée, 0,50 $ par 1 M de tokens de sortie) et vous pouvez calculer vous-même le coût de n'importe quelle requête, puis le comparer avec la baisse du solde. Les deux doivent correspondre. S'ils ne correspondent pas, vous avez trouvé un point à investiguer. Les détails complets des paramètres sont dans la documentation.
Lisez l'en-tête en une requête
Avec curl, ajoutez -i et examinez les en-têtes :
curl -si https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say hi."}]}' \
| grep -i "x-balance-usd"
En Python, le SDK OpenAI expose les réponses brutes via with_raw_response, ce qui vous donne les en-têtes et l'objet analysé ensemble :
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
raw = client.chat.completions.with_raw_response.create(
model="uncensored",
messages=[{"role": "user", "content": "Say hi."}],
)
resp = raw.parse()
print(raw.headers.get("x-balance-usd"), resp.usage.total_tokens)Un petit logger qui enregistre chaque appel
Enveloppez vos appels dans une seule fonction et écrivez une ligne CSV à chaque fois. La ligne contient l'heure, l'ID de requête, les comptes de tokens, le coût calculé et le solde.
import csv, time
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
PRICE_IN, PRICE_OUT = 0.15, 0.50 # dollars per 1M tokens
LOG = "api_spend.csv"
def cost(usage):
return (usage.prompt_tokens * PRICE_IN + usage.completion_tokens * PRICE_OUT) / 1_000_000
def tracked_chat(messages, tag="default"):
raw = client.chat.completions.with_raw_response.create(
model="uncensored", messages=messages)
r = raw.parse()
row = [
time.strftime("%Y-%m-%d %H:%M:%S"),
raw.headers.get("x-request-id"),
tag,
r.usage.prompt_tokens,
r.usage.completion_tokens,
round(cost(r.usage), 6),
raw.headers.get("x-balance-usd"),
]
with open(LOG, "a", newline="") as f:
csv.writer(f).writerow(row)
return r, row
L'argument tag est l'astuce qui rend le journal utile. Indiquez un nom de fonctionnalité comme « résumés » ou « chat », puis additionnez les coûts par tag pour voir quelle partie du produit consomme l'argent. L'ID de requête aide si vous devez demander des informations à propos d'un prélèvement ou signaler un problème, car il identifie l'appel exact.
Vérification de base des calculs
Prenons un appel avec 2 400 tokens d'entrée et 600 tokens de sortie :
- Entrée : 2 400 x 0,15 / 1 000 000 = $0,00036
- Sortie : 600 x 0,50 / 1 000 000 = $0,00030
- Total : $0,00066
Un millier de ces appels coûtent $0,66. Si votre CSV affiche un solde qui chute beaucoup plus vite que la somme des coûts calculés, vérifiez les nouvelles tentatives non journalisées, les tâches en arrière-plan utilisant la même clé, ou les streams que vous avez laissés ouverts. Les requêtes échouées ou refusées ne sont pas facturées, donc les erreurs ne doivent pas modifier le solde. Comparez les totaux sur de nombreux appels, pas sur un seul, pour que les petites différences d'arrondi s'annulent.
Appels en streaming et utilisation
Avec stream: true, les chiffres d'utilisation arrivent à la fin du flux. Collectez-les à partir du dernier bloc, puis enregistrez la ligne après la fermeture du flux.
def tracked_stream(messages, tag="chat"):
usage = None
for chunk in client.chat.completions.create(
model="uncensored", messages=messages, stream=True):
if chunk.choices and chunk.choices[0].delta.content:
yield chunk.choices[0].delta.content
usage = getattr(chunk, "usage", None) or usage
if usage:
with open(LOG, "a", newline="") as f:
csv.writer(f).writerow([time.strftime("%F %T"), "", tag,
usage.prompt_tokens, usage.completion_tokens, round(cost(usage), 6), ""])
Si vous avez seulement besoin du solde, appelez GET /v1/balance après la fin du flux. C'est une requête peu coûteuse, et elle fonctionne aussi comme vérification périodique depuis un job cron.
Somme des dépenses par fonctionnalité
Le CSV n'est utile que si vous le lisez. Ce court script totalise les coûts par tag et affiche le solde le plus récent, sans packages supplémentaires.
import csv
from collections import defaultdict
totals, last_balance = defaultdict(float), None
with open("api_spend.csv") as f:
for row in csv.reader(f):
ts, req_id, tag, pin, pout, cost_usd, balance = row
totals[tag] += float(cost_usd)
last_balance = balance or last_balance
for tag, usd in sorted(totals.items(), key=lambda kv: -kv[1]):
print(f"{tag:15s} ${usd:.4f}")
print("latest balance:", last_balance)
Exécutez-le quotidiennement et collez la sortie dans le canal de votre équipe. Les dépenses qui étaient invisibles deviennent un nombre que les gens peuvent discuter, et une fonctionnalité qui coûte dix fois les autres se distingue immédiatement. Pour un budget approximatif, multipliez le total quotidien par 30 et ajoutez 20 % de marge de sécurité.
Ajoutez une alerte de solde bas
Manquer de crédit en milieu de journée met un produit hors ligne, donc alertez tôt. Un job cron qui s'exécute toutes les 15 minutes suffit.
import requests
BASE = "https://api.uncensoredaiapis.com/v1"
THRESHOLD = 5.00 # dollars
r = requests.get(BASE + "/balance", headers={"Authorization": "Bearer sk-your-key"}, timeout=10)
print(r.status_code, r.text) # inspect the JSON once to see the field name
# After you know the field name, parse it and compare with THRESHOLD,
# then post to your chat webhook or send an email.
Imprimez le JSON brut une fois et examinez-le avant d'écrire le code d'analyse. Le vrai nom de champ prend dix secondes à vérifier, et le deviner depuis un article peut faire échouer l'alerte silencieusement. Choisissez un seuil qui couvre au moins une journée de dépenses normales, ce que le CSV vous indique : sommez le coût d'hier et utilisez-le comme minimum.
Lorsque l'alerte se déclenche, rechargez. Tout montant entier de 20 $ à 500 $ convient, avec +5 % de crédit à partir de 50 $, +10 % à partir de 100 $ et +15 % à partir de 200 $, et le crédit n'expire pas. Pour obtenir d'abord une clé pour le tracker, utilisez la page clé API.
Les habitudes pour des dépenses prévisibles
- Utilisez une clé par environnement pour que le trafic de test ne se cache jamais dans les chiffres de production.
- Limitez
max_tokenssur les endpoints où de longues réponses ne sont pas nécessaires. C'est optionnel par défaut, donc des réponses illimitées sont possibles. - Réduisez l'historique de chat. Les tokens d'entrée sont moins chers que les tokens de sortie, mais un long historique répété à chaque tour s'accumule.
- Examinez le total hebdomadaire par tag, et cherchez le tag unique qui représente plus de la moitié de la facture.
Une autre habitude : stockez l'ID de requête avec chaque ligne journalisée. Si un nombre semble faux un mois plus tard, vous pouvez le faire correspondre à un appel spécifique au lieu de débattre à partir de moyennes. Comme les requêtes échouées ne sont pas facturées, les nouvelles tentatives sur les erreurs n'ajoutent pas de coût, mais les nouvelles tentatives après une réponse réussie oui, alors assurez-vous que votre logique de nouvelle tentative ne se déclenche que sur de vraies erreurs. Un bug qui renvoie en boucle une requête réussie est la cause la plus courante d'une facture surprise avec n'importe quelle API facturée au token.
Plus de guides
Questions et réponses
L'en-tête du solde apparaît-il sur chaque réponse ?
L'en-tête X-Balance-USD fait partie des en-têtes de réponse listés pour cette API. Lisez-le depuis la réponse brute et considérez une valeur manquante comme inconnue.
Puis-je obtenir le coût sans journaliser chaque requête ?
Oui. Interrogez GET /v1/balance selon un calendrier et calculez la différence entre les relevés.
Les requêtes échouées modifient-elles le solde ?
Non. Les requêtes échouées ou refusées ne sont pas facturées.
Quel endpoint un outil existant du tableau de bord OpenAI doit-il utiliser ?
Utilisez la route GET /v1/dashboard/billing/credit_grants de style OpenAI, que de nombreux outils prennent déjà en charge.
Votre clé n'est qu'à un formulaire d'ici
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.