Coût de l'API Claude : une nouvelle API montre qui dépense les tokens

Le 29 octobre, Anthropic a lancé en bêta l’Usage and Cost Analytics API, une nouvelle API de reporting sur la consommation de tokens et le coût de l’API Claude au sein d’une organisation. D’après les Claude Release Notes, l’actuelle Usage and Cost API devient à partir de ce jour une API « legacy », même si elle reste prise en charge.

Quoi de neuf dans le suivi du coût de l’API Claude ?

L’API compte deux endpoints :

1. GET /v1/organizations/analytics/usage renvoie le nombre de tokens et de requêtes,
2. GET /v1/organizations/analytics/cost renvoie le coût en USD.

Le plus intéressant, c’est la façon dont on peut découper ces données. En une seule requête, on regroupe les résultats selon cinq dimensions au maximum : modèle, workspace, clé API, niveau de service, fenêtre de contexte, région d’inférence, produit et ce qu’on appelle l’« acteur », c’est-à-dire celui qui a réellement envoyé la requête. L’acteur peut être un utilisateur, un compte de service, une identité AWS ou Google Cloud ou, à défaut, la clé API elle-même.

Les résultats arrivent sous forme de classement, triés par défaut de la plus forte consommation à la plus faible. La question « quelles clés API ont le plus dépensé ce mois-ci ? » tient donc en une seule requête, et non dans un script qui recolle les données de plusieurs rapports.

Pour Claude Code, il existe une recette toute prête : le coût par utilisateur s’obtient avec une requête products[]=claude_code&group_by[]=actor. Après les mesures selon lesquelles les résumés cachés des agents engloutissent 16 à 22 % du coût d’une session, ça tombe à pic.

À quoi ressemble une requête ?

Un exemple tiré de la documentation : la consommation quotidienne de tokens pendant la première semaine de septembre, séparément pour chaque modèle.

curl --globoff "https://api.anthropic.com/v1/organizations/analytics/usage?\
starting_at=2026-09-01T00:00:00Z&\
ending_at=2026-09-08T00:00:00Z&\
time_bucket_width=1d&\
group_by[]=model&\
limit=10" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: analytics-usage-cost-2026-08-24" \
  -H "x-api-key: $ANTHROPIC_API_KEY"

Chaque ligne comporte trois parties : la plage horaire, group avec les dimensions et usage (ou cost) avec les chiffres. Dans usage, on trouve entre autres les tokens d’entrée hors cache, les tokens écrits et lus dans le cache, les tokens de sortie, le nombre de recherches web et le nombre de requêtes. La même chose est disponible via le SDK et la CLI ant (ant beta:organization:analytics:usage list).

Quelques détails :

1. Les intervalles de temps sont de 1 minute, 1 heure ou 1 jour, le tout en UTC.
2. Une requête couvre 31 jours au maximum, et seulement 24 heures avec des intervalles d’une minute.
3. Les données remontent jusqu’au 1er janvier 2026, et 365 jours au plus.
4. Une page de résultats contient de 1 à 1000 lignes (20 par défaut).

Que montre l’endpoint des coûts ?

L’endpoint /cost renvoie deux montants : amount, c’est-à-dire le coût après remises mais avant déduction des crédits, et list_amount, le coût au prix catalogue. Les montants sont exprimés en cents avec six décimales, donc "41280.000000" signifie 412,80 USD.

Deux dimensions supplémentaires, cost_type et token_type, ventilent le coût entre les différents types de tokens, la recherche web, l’exécution de code et les sessions. Elles ne comptent pas dans la limite des cinq dimensions.

À quoi faut-il faire attention ?

D’abord, au délai. Les données se mettent à jour généralement en 4 heures, parfois jusqu’à 24 heures, alors que dans l’ancienne Usage and Cost API elles apparaissaient en général en 5 minutes. Pour des alertes « ici et maintenant », mieux vaut chercher autre chose.

Ensuite, aux corrections. Les valeurs peuvent encore changer pendant environ 7 jours après la fin du mois civil : on aura donc les totaux définitifs d’octobre vers le 7 novembre.

Troisièmement, au Priority Tier. Les requêtes passées dans le cadre d’un Priority Tier souscrit apparaissent dans la consommation, mais leur coût en tokens est nul, car l’engagement est facturé à part.

Enfin, à l’accès. L’API ne fonctionne que pour les organisations : dans la Claude Console avec une clé Admin API, et dans Claude Enterprise avec une clé disposant de la permission read:analytics. Les comptes individuels ne peuvent pas l’utiliser. Elle fonctionne aussi sur Claude Platform on AWS et dans Claude Models on Google Cloud, avec l’authentification du cloud concerné.

Est-ce une nouveauté dans le monde de l’IA ?

Les rapports de coûts existaient déjà dans la Claude Console. Ce qui change, c’est que les mêmes endpoints et les mêmes champs servent à la fois les organisations de la Claude Console et Claude Enterprise. Pour Enterprise, c’est aussi la fin d’une limite : les anciens rapports ne renvoyaient que les 100 plus gros groupes de chaque intervalle, les nouveaux les renvoient tous.

C’est un pas de plus d’Anthropic vers la maîtrise des dépenses, juste après les Claude smart reports, qui montrent ce qu’une équipe a fait avec Claude et combien cela a coûté.

FAQ

Comment vérifier le coût de l’API Claude ?

Dans la Claude Console, sur les pages Usage et Cost, ou par programme via l’Usage and Cost Analytics API (endpoint /v1/organizations/analytics/cost) avec une clé Admin API. Chaque réponse de l’API contient aussi un bloc usage avec le nombre de tokens de la requête.

L’ancienne Usage and Cost API va-t-elle cesser de fonctionner ?

Au 29 octobre, non. D’après les Claude Release Notes, elle a le statut « legacy » mais reste prise en charge, et la documentation contient un guide de migration.

Comment savoir combien dépense chaque utilisateur de Claude Code ?

Avec l’endpoint des coûts et les paramètres products[]=claude_code&group_by[]=actor. Les organisations de la Claude Console peuvent aussi utiliser la Claude Code Analytics API, qui est distincte.