---
title: Comprendre la consommation
description: Les états d'un appel au modèle, la différence entre usage inconnu, consommation nulle et reprise réutilisée, et le calcul des coûts.
---

# Comprendre la consommation

Chaque appel d'un agent au modèle est inscrit dans le registre de consommation, avec ses jetons et, quand c'est possible, son coût. La plateforme ne transforme jamais une valeur inconnue en zéro : cette page explique comment lire chaque état.

**Qui peut le faire** : tout membre du projet consulte la consommation de ses projets. L'Administrateur voit celle de toute l'organisation.

## Les jetons

Un **jeton** (token) est l'unité de facturation du fournisseur de modèles. Chaque appel compte :

- les **jetons en entrée**, y compris les jetons servis depuis le cache du fournisseur ;
- les **jetons en sortie**, y compris les jetons de raisonnement ;
- le **total**.

Avant chaque appel, la plateforme **réserve** une quantité prudente de jetons sur le budget. La réponse du fournisseur établit ensuite l'usage réel, et la réserve est libérée.

## Trois états à ne jamais confondre

| État | Définition | Effet sur le budget |
| --- | --- | --- |
| **Usage inconnu** | L'appel a eu lieu, mais le fournisseur n'a pas confirmé les jetons consommés. | La réserve reste engagée ; aucun nouvel appel n'est permis pour cette issue. |
| **Consommation nulle confirmée** | Le fournisseur a confirmé zéro jeton. | Aucune consommation. |
| **Reprise réutilisée** | Étape reprise sans nouvel appel, gratuite et comptée à part. | Aucune consommation. |

Un usage inconnu survient par exemple quand un appel est interrompu (arrêt du worker, coupure réseau) avant la réponse. L'étape correspondante est **Indéterminé** et n'est pas relancée automatiquement.

> [!WARNING]
> Un usage inconnu n'est pas un usage nul. L'appel a pu être facturé par le fournisseur. Les totaux affichés excluent ces appels et les signalent à part.

## Appel non chiffré

Un appel peut avoir des jetons connus sans coût connu. Il est alors **non chiffré**. Cela arrive quand aucun tarif ne correspond au modèle à la date de l'appel, quand le tarif du cache manque, quand le modèle réellement utilisé diffère du modèle configuré, ou quand le détail d'usage est insuffisant.

## Les tarifs figés

L'exploitant configure un catalogue de tarifs contractuels : prix par million de jetons en entrée, en entrée cachée et en sortie, avec une devise et une date d'effet. Voir [Variables d'environnement](../08-deploiement-et-exploitation/02-variables-d-environnement.md).

Au moment de la réservation, le tarif en vigueur est **figé** dans l'entrée du registre, avec sa provenance. Un tarif publié plus tard ne modifie jamais une entrée déjà enregistrée. Les montants sont calculés exactement et restent séparés par devise : la plateforme ne convertit pas les devises entre elles.

Les montants connus sont des **estimations** issues des volumes et du contrat configuré. Ils ne remplacent pas la facture du fournisseur.

## Lire l'onglet Consommation d'une exécution

Le détail d'une exécution propose l'onglet **Consommation**. La carte **Usage par étape** affiche une ligne par appel :

| Affichage | Signification |
| --- | --- |
| `12 480 jetons · 10 200 en entrée · 2 280 en sortie` | Usage connu ; la ligne suivante détaille **Cache** et **Raisonnement** (« inconnu » si le fournisseur ne les donne pas) |
| **Appel en cours** | Réservation posée, réponse attendue |
| **Usage inconnu** | Voir le tableau ci-dessus |
| **Réutilisée · aucun nouvel appel** | Reprise réutilisée |

À droite, le coût : un montant suivi de sa devise, **Gratuite** pour une reprise réutilisée, ou **Coût inconnu**. Sans appel, la carte indique « Aucun appel enregistré. ».

La carte **Budgets** est décrite dans [Budgets et plafonds](04-budgets-et-plafonds.md).

## Maintenance réelle et banc d'essai

Les appels du [banc d'essai](../04-audits-et-banc-d-essai/08-banc-d-essai.md) en mesure réelle sont classés dans la catégorie **Banc d'essai**, séparée de la **Maintenance réelle**. Ils n'apparaissent jamais dans les totaux de maintenance. Les simulations du banc ne créent aucune entrée.

## Ce que les rapports clients ne montrent pas

Les jetons et les coûts n'apparaissent jamais dans les rapports PDF. Ils restent dans la plateforme, sur les écrans de consommation et dans les exports CSV.

## Pour continuer

[Budgets et plafonds](04-budgets-et-plafonds.md)
