Où lire le nombre de jetons réellement facturés ?

Dans l'objet usage de chaque réponse de l'API. Chez Anthropic, il donne input_tokens, cache_creation_input_tokens, cache_read_input_tokens et output_tokens, chacun à multiplier par son propre prix.

Le champ input_tokens donne-t-il toute l'entrée ?

Non, quand le cache est actif. Il ne compte que les jetons situés après le dernier point de cache. L'entrée totale est la somme de cache_read_input_tokens, cache_creation_input_tokens et input_tokens.

Calculer le coût d'un appel API d'IA : la méthode

Le coût d'un appel API (interface de programmation) se calcule à partir de ce que l'API renvoie elle-même : chaque réponse contient un objet usage qui détaille les jetons consommés, par catégorie. On multiplie chaque catégorie par son prix au million de jetons, on additionne, on divise par un million. Le calcul ci-dessous suit la documentation d'Anthropic lue le 15/11/2026 ; les autres éditeurs suivent la même logique avec leurs propres noms de champs.

La formule

Pour un appel à Claude sans outil côté serveur :

coût = ( input_tokens                × prix d'entrée
       + cache_creation_input_tokens × prix d'écriture en cache
       + cache_read_input_tokens     × prix de lecture du cache
       + output_tokens               × prix de sortie ) / 1 000 000

La documentation précise le sens de chaque champ :

Champ	Ce qu'il compte
`input_tokens`	les jetons d'entrée ni lus ni écrits en cache, c'est-à-dire ceux situés après le dernier point de cache
`cache_creation_input_tokens`	les jetons écrits dans le cache par cette requête
`cache_read_input_tokens`	les jetons relus depuis le cache
`output_tokens`	les jetons produits par le modèle

Piège fréquent : quand le cache est actif, input_tokens est petit, parce qu'il ne compte que la fin de la requête. L'entrée totale vaut cache_read_input_tokens + cache_creation_input_tokens + input_tokens.

Les prix à mettre dans la formule

Relevés le 15/11/2026 chez Anthropic, en dollars américains par million de jetons :

Modèle	Entrée	Écriture cache 5 min	Écriture cache 1 h	Lecture cache	Sortie
Claude Opus 5.5	4 $	5 $	8 $	0,20 $	20 $
Claude Sonnet 5.5	2 $	2,50 $	4 $	0,10 $	10 $
Claude Haiku 5.5 (jusqu'à 100 000 jetons)	0,10 $	0,125 $	0,20 $	0,01 $	0,50 $

Exemple illustratif

Prenons un assistant interne sur Claude Sonnet 5.5 : des consignes fixes de 3 000 jetons mises en cache, puis 2 200 jetons qui changent à chaque fois (extraits de documents et question), et une réponse de 500 jetons.

Sans cache : 5 200 × 2 + 500 × 10 = 15 400, divisé par un million, soit 0,0154 $ par appel.

Premier appel avec cache (écriture pour 5 minutes) :

Catégorie	Calcul	Coût
Écriture en cache	3 000 × 2,50 / 1 000 000	0,0075 $
Entrée hors cache	2 200 × 2 / 1 000 000	0,0044 $
Sortie	500 × 10 / 1 000 000	0,0050 $
Total		0,0169 $

Appels suivants (lecture du cache) :

Catégorie	Calcul	Coût
Lecture du cache	3 000 × 0,10 / 1 000 000	0,0003 $
Entrée hors cache	2 200 × 2 / 1 000 000	0,0044 $
Sortie	500 × 10 / 1 000 000	0,0050 $
Total		0,0097 $

Sur 1 000 appels où le cache reste chaud, le calcul donne environ 9,71 $ au lieu de 15,40 $. Ces chiffres découlent seulement des prix publics et des hypothèses de taille choisies ici ; vos requêtes réelles donneront d'autres valeurs.

Ce qui s'ajoute à la formule

Les outils. Dès que vous déclarez des outils, l'API ajoute un message système dédié : 286 jetons pour Claude Sonnet 5.5 et Claude Opus 5.5 d'après la page tarifs. Les définitions d'outils, les appels et leurs résultats comptent aussi comme jetons.
Les outils côté serveur. La recherche web d'Anthropic coûte 10 $ pour 1 000 recherches, plus les jetons des résultats lus. La lecture de pages web n'est facturée qu'en jetons.
La résidence des données. Pour les modèles Claude 4.6 et suivants, imposer un traitement aux États-Unis avec inference_geo: "us" multiplie tous les prix par 1,1.
Le mode rapide. Sur Claude Opus 5.5, il passe l'entrée à 8 $ et la sortie à 40 $ par million de jetons.
Le traitement par lots. Il divise par deux l'entrée et la sortie, et se cumule avec le cache : voir la page traitement par lots du site API.

Passer du coût d'un appel au coût mensuel

Enregistrez l'objet usage de chaque appel dans vos journaux, avec le nom du modèle.
Appliquez la formule en tâche de fond, chaque jour.
Additionnez par fonction de l'application (recherche, rédaction, classement) pour savoir laquelle coûte.
Rapprochez votre total du suivi d'usage de la console de l'éditeur (page Usage de la console Claude chez Anthropic) : un écart signale un appel mal journalisé.

Pour estimer une requête avant de l'envoyer, utilisez plutôt le comptage des jetons. Pour comparer les prix entre éditeurs, voir la grille des tarifs d'API.