Guide
Suivre ses dépenses d'API d'IA et poser des alertes
Où lire sa consommation chez Anthropic, Google et Mistral, comment l'extraire par API et poser des alertes de budget. Documentation lue le 15/11/2026.
Mis à jour le
Pour suivre la dépense d'une API (interface de programmation) d'IA, chaque éditeur propose une page de consommation dans sa console, et certains permettent d'extraire ces chiffres automatiquement pour construire vos propres alertes. Au 15/11/2026 : Anthropic a des pages Usage et Cost dans la console Claude et une API d'administration pour les lire ; Google affiche la consommation dans Google AI Studio et les coûts dans Cloud Billing, avec des budgets et des alertes par courriel ; Mistral permet, depuis son espace d'administration, de créer des espaces de travail isolés et de fixer des limites d'usage. Une alerte prévient ; seul un plafond arrête.
La documentation API d’ALMA permet de préparer les échanges avec une plateforme d’assistants. Demandez les données de consommation disponibles et leur granularité avant de concevoir votre tableau de suivi interne.
Où lire sa consommation
| Éditeur | Où | Ce qu'on y voit |
|---|---|---|
| Anthropic | console Claude, pages Usage (platform.claude.com/usage) et Cost (platform.claude.com/cost) |
jetons, requêtes, part de l'entrée lue en cache, coûts ; export détaillé par clé et par modèle |
| Google AI Studio, Dashboard puis Usage ; page Spend ; rapports de coûts de la console Cloud Billing | consommation de l'API Gemini, plafond de dépense du projet, coûts | |
| Mistral | espace d'administration (organisation, facturation, espaces de travail) | création d'espaces de travail isolés et de clés, réglage de limites d'usage |
Anthropic : extraire les chiffres par API
La documentation d'Anthropic décrit une API d'administration qui donne accès à l'historique d'usage et de coût de l'organisation, avec des données « similaires » à celles des pages Usage et Cost. Deux versions existent : l'API Usage and Cost, dite ancienne mais toujours prise en charge, et l'API Usage and Cost Analytics, recommandée pour les nouvelles intégrations.
Ce que dit la page lue le 15/11/2026 sur l'ancienne version :
| Point | Usage (/v1/organizations/usage_report/messages) |
Coût (/v1/organizations/cost_report) |
|---|---|---|
| Granularité | par minute, heure ou jour | par jour seulement |
| Découpage | clé d'API, espace de travail, modèle, niveau de service, résidence des données, vitesse | espace de travail, description (dont le modèle) |
| Contenu | entrée hors cache, entrée en cache, écriture en cache, sortie, outils côté serveur | jetons, recherche web, exécution de code |
| Devise | — | dollars américains, en cents |
Autres points utiles :
- il faut une clé d'administration ; les clés d'un espace de travail ne fonctionnent pas ;
- l'API d'administration n'est pas disponible pour le forfait Team de claude.ai ni pour un compte individuel de la console, qui doit d'abord créer une organisation ;
- les données apparaissent en général dans les 5 minutes après la requête ;
- l'API accepte une interrogation par minute en usage continu ;
- l'usage de l'espace de travail par défaut apparaît avec un
workspace_idvide.
La page liste aussi des outils de suivi qui se branchent sur ces données sans code (Datadog, Grafana Cloud, CloudZero, Vantage, entre autres).
Google : budgets et alertes
Pour l'API Gemini en niveau payant, la documentation de facturation de Google indique qu'il faut relier un compte de facturation, que les niveaux et les plafonds se décident au niveau de ce compte, et que l'usage se suit dans Google AI Studio. Elle décrit deux plafonds :
- un plafond mensuel par projet, expérimental, réglable sur la page Spend ;
- un plafond par niveau du compte de facturation : 250 $ au niveau 1, 2 000 $ au niveau 2, de 20 000 à 100 000 $ au niveau 3. Une fois le plafond atteint, le service s'arrête jusqu'au cycle de facturation suivant.
Côté Cloud Billing, un budget suit les coûts réels par rapport au prévu et envoie des courriels à des seuils qui valent par défaut 50 %, 90 % et 100 % du montant. Deux mises en garde de la documentation : un budget en mode alertes seulement ne plafonne pas la dépense, et les coûts remontent avec un délai, d'où le conseil de fixer le budget en dessous des fonds disponibles. Un seuil peut porter sur le coût réel ou sur le coût prévu en fin de période.
Construire sa propre alerte
Les consoles donnent une vue d'ensemble ; votre application peut faire mieux en suivant sa dépense par fonction.
- Journalisez l'objet
usagede chaque réponse, avec le modèle, la fonction de l'application et l'heure. - Calculez le coût de chaque appel avec les prix du jour (méthode : calculer le coût d'un appel).
- Cumulez par jour et par mois, et comparez au budget.
- Alertez à des seuils fixés à l'avance, par exemple sur le modèle des seuils par défaut de Google (la moitié, presque tout, la totalité du budget).
- Rapprochez chaque semaine votre total de celui de la console ; un écart signale un appel non journalisé.
Avec l'API d'administration d'Anthropic, l'étape 2 peut se remplacer par une lecture du rapport de coûts, au prix d'un décalage de quelques minutes et d'une granularité à la journée.
Ce qu'il faut surveiller en priorité
| Signal | Ce qu'il peut indiquer |
|---|---|
| Hausse brutale des jetons d'entrée | un historique de conversation qui n'est plus résumé, une boucle d'agent |
| Part du cache qui baisse | une consigne devenue variable en début de requête (voir cache de prompt) |
| Hausse d'un seul modèle | un routage qui envoie trop de requêtes au grand modèle |
| Recherches web en hausse | un outil appelé plus souvent que prévu |
Une alerte ne remplace pas un plafond : la limite de dépense qui arrête les appels se règle à part, voir plafonner les dépenses.
Questions fréquentes
Une alerte de budget arrête-t-elle la dépense ?
Pas toujours. Chez Google Cloud, un budget en mode alertes seulement envoie des courriels mais ne plafonne pas l'usage. Pour arrêter la dépense, il faut un plafond : limite de dépense dans la console Claude, plafond mensuel de projet dans Google AI Studio.
Avec quel délai la consommation apparaît-elle ?
Chez Anthropic, les données d'usage et de coût apparaissent en général dans les 5 minutes après la requête, parfois plus tard. Google signale un délai entre l'usage et sa remontée dans Cloud Billing, sans le chiffrer.
Sources
Pages consultées pour écrire cet article :
- https://alma.iarche.fr/fr/api-docs
- https://platform.claude.com/docs/en/manage-claude/usage-cost-api
- https://platform.claude.com/docs/en/api/rate-limits
- https://aistudio.google.com/docs/billing
- https://docs.cloud.google.com/billing/docs/how-to/budgets
- https://docs.mistral.ai/getting-started/quickstart/
- https://platform.claude.com/docs/en/about-claude/model-deprecations