Page Consommation et export CSV
La page Consommation agrège le registre des appels aux modèles : jetons, usage inconnu, réserves, reprises réutilisées et coûts estimés. Elle sert à suivre le coût d'un projet ou de toute l'organisation, et à l'exporter.
Qui peut le faire : tout membre d'un projet voit la consommation des projets dont il est membre. L'Administrateur voit toute l'organisation.
Ouvrir la page#
Deux accès mènent à la même page, /usage :
- Vue d'un projet : dans la barre Espace projet, cliquez sur Consommation. La page s'ouvre filtrée sur le projet (
/usage?project=<projectId>). - Vue transverse : dans la barre Supervision, cliquez sur Consommation. La page couvre tous vos projets.
L'encadré Lecture des montants rappelle les règles de lecture, détaillées dans Comprendre la consommation.
Filtrer et regrouper#
| Champ | Effet |
|---|---|
| Du (UTC) | Premier jour inclus |
| Au (UTC, inclus) | Dernier jour inclus ; 366 jours au plus entre les deux dates |
| Regrouper par | Projet, Dépôt, Modèle, Pull request ou Jour (UTC) |
| Catégorie | Maintenance réelle ou Banc d'essai |
| Projet | Tous mes projets ou un projet |
| Modèle exact | Identifiant exact du modèle |
| Pull request n° | Numéro de la PR d'origine |
Cliquez sur Filtrer pour appliquer, ou sur Réinitialiser. Sans dates, la période couvre les 30 derniers jours. Les filtres sont écrits dans l'adresse : vous pouvez enregistrer une vue en favori.
Cliquez sur le nom d'un projet dans le tableau pour descendre au niveau des dépôts de ce projet.
Lire le tableau#
| Colonne | Contenu |
|---|---|
| Appels | Nombre d'appels au modèle |
| Jetons connus | Total des jetons confirmés |
| Usage inconnu | Appels dont le fournisseur n'a pas confirmé les jetons (badge d'avertissement) |
| Jetons réservés | Réserve encore engagée |
| Reprises réutilisées | Étapes reprises sans nouvel appel |
| Coût estimé | Montants connus par devise ; Aucun coût connu ou Aucun appel sinon ; badge « N appel(s) non chiffré(s) » et « N en cours » le cas échéant |
Les montants sont affichés avec douze décimales, par exemple 12.400000000000 EUR. Plusieurs devises s'affichent côte à côte, séparées par +, jamais additionnées. Si plus de 200 groupes correspondent, l'encadré Résultat tronqué demande de réduire la période ou de choisir un projet. Sans résultat, la page affiche Aucune consommation.
Exporter en CSV#
Le lien Exporter ce regroupement en CSV télécharge le fichier 101maintain-usage-overview.csv, avec les mêmes projets, filtres et regroupement que la page. L'export est tracé dans le journal des actions. Il contient au plus 5 000 groupes.
| Colonne | Contenu |
|---|---|
project_id, repository_id, model, pull_request, day | Clés du groupe (vides si non pertinentes) |
calls | Appels |
unknown_usage_calls | Appels à usage inconnu |
pending_calls | Appels en cours |
unpriced_calls | Appels non chiffrés |
reused_steps | Reprises réutilisées |
input_tokens, output_tokens, total_tokens | Jetons connus |
held_tokens | Jetons encore réservés |
known_costs | Coûts connus par devise, par exemple 12.400000000000 EUR |
Une valeur inconnue reste vide, jamais 0. Les cellules qui commencent par =, +, - ou @ sont neutralisées pour les tableurs.
Détail appel par appel d'un projet#
Le détail ligne par ligne n'a pas d'écran. Il est servi par deux points d'accès de données, avec votre session : /projects/<projectId>/usage (JSON) et /projects/<projectId>/usage.csv (fichier 101maintain-usage.csv). Ils acceptent les filtres kind (live ou evaluation), from et to (horodatages ISO UTC, to exclu), repository, model et pull.
Le CSV détaillé compte une ligne par appel : started_at, kind, repository_id, issue, pull_request, run_id, sequence, role, model, state, les jetons (input_tokens, output_tokens, cached_input_tokens, reasoning_output_tokens, total_tokens), reserved_tokens, cost, currency, le tarif figé (rate_input, rate_output, rate_cached_input, rate_effective_from, rate_source) et held_tokens. Au-delà de 5 000 appels, choisissez une période plus courte.
La consommation est aussi lisible par l'API (scope usage:read) : voir Intégration API et Ressources pour agents IA.
Exemple : suivi mensuel des coûts#
- Barre Supervision › Consommation.
- Du (UTC) : premier jour du mois ; Au (UTC, inclus) : dernier jour.
- Catégorie : Maintenance réelle ; Regrouper par : Projet ; Filtrer.
- Vérifiez la colonne Usage inconnu : chaque appel inconnu est un coût possible non mesuré.
- Cliquez sur Exporter ce regroupement en CSV et joignez le fichier à votre suivi.
- Répétez avec Catégorie : Banc d'essai pour isoler le coût des évaluations.
Pour continuer#
Chapitre suivant : Comptes et invitations