Rapports, usage et coûts

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#

ChampEffet
Du (UTC)Premier jour inclus
Au (UTC, inclus)Dernier jour inclus ; 366 jours au plus entre les deux dates
Regrouper parProjet, Dépôt, Modèle, Pull request ou Jour (UTC)
CatégorieMaintenance réelle ou Banc d'essai
ProjetTous mes projets ou un projet
Modèle exactIdentifiant 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#

ColonneContenu
AppelsNombre d'appels au modèle
Jetons connusTotal des jetons confirmés
Usage inconnuAppels dont le fournisseur n'a pas confirmé les jetons (badge d'avertissement)
Jetons réservésRé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.

ColonneContenu
project_id, repository_id, model, pull_request, dayClés du groupe (vides si non pertinentes)
callsAppels
unknown_usage_callsAppels à usage inconnu
pending_callsAppels en cours
unpriced_callsAppels non chiffrés
reused_stepsReprises réutilisées
input_tokens, output_tokens, total_tokensJetons connus
held_tokensJetons encore réservés
known_costsCoû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#

  1. Barre Supervision › Consommation.
  2. Du (UTC) : premier jour du mois ; Au (UTC, inclus) : dernier jour.
  3. Catégorie : Maintenance réelle ; Regrouper par : Projet ; Filtrer.
  4. Vérifiez la colonne Usage inconnu : chaque appel inconnu est un coût possible non mesuré.
  5. Cliquez sur Exporter ce regroupement en CSV et joignez le fichier à votre suivi.
  6. Répétez avec Catégorie : Banc d'essai pour isoler le coût des évaluations.

Pour continuer#

Chapitre suivant : Comptes et invitations