---
title: Page Consommation et export CSV
description: Consulter la consommation d'un projet ou de toute l'organisation, la filtrer, la regrouper et l'exporter en CSV.
---

# 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](03-comprendre-la-consommation.md).

## 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](../07-integration-api/01-vue-d-ensemble.md) et [Ressources pour agents IA](../07-integration-api/07-agent-ia.md).

## 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](../06-administration-et-supervision/01-comptes-et-invitations.md)
