--- title: API d'utilisation et de coûts url: https://platform.claude.com/docs/fr/manage-claude/usage-cost-api description: Accédez par programmation aux données d'utilisation et de coûts de l'API de votre organisation avec l'API Usage and Cost de l'Admin API. --- **L'Admin API n'est pas disponible pour les comptes individuels.** Pour collaborer avec vos coéquipiers et ajouter des membres, configurez votre organisation sur la page [Organization](https://platform.claude.com/settings/organization) (`platform.claude.com/settings/organization`) dans la Claude Console. L'API Usage and Cost de l'Admin API fournit un accès programmatique et granulaire aux données historiques d'utilisation et de coûts de l'API pour votre organisation. Ces données sont similaires aux informations disponibles sur la page [Usage](https://platform.claude.com/usage) (`platform.claude.com/usage`) et la page [Cost](https://platform.claude.com/cost) (`platform.claude.com/cost`) dans la Claude Console. Cette API vous permet de mieux surveiller, analyser et optimiser vos implémentations de Claude : * **Suivi précis de l'utilisation :** obtenez des décomptes de tokens précis et des schémas d'utilisation au lieu de vous fier uniquement au comptage des tokens de réponse. * **Rapprochement des coûts :** faites correspondre vos registres internes avec la facturation d'Anthropic pour les équipes financières et comptables. * **Performance et amélioration du produit :** surveillez la performance du produit tout en mesurant si les modifications apportées au système l'ont amélioré, ou configurez des alertes. * **Optimisation des [limites de débit](https://platform.claude.com/docs/fr/api/rate-limits) :** optimisez des fonctionnalités telles que le « prompt caching » ([mise en cache des prompts](https://platform.claude.com/docs/fr/build-with-claude/prompt-caching)) ou des prompts spécifiques pour tirer le meilleur parti de votre capacité allouée. * **Analyse avancée :** effectuez des analyses de données plus approfondies que celles disponibles dans la Console. **Identifiants de l'Admin API requis.** Ces points de terminaison font partie de l'Admin API. Vous pouvez y accéder à l'aide d'une [clé Admin API](https://platform.claude.com/docs/fr/manage-claude/admin-api-keys), d'un jeton OAuth avec la portée `org:admin`, ou d'une clé de compte personnel ou de compte de service qui n'est pas limitée à un espace de travail ; les clés API d'espace de travail ne fonctionnent pas. Consultez la section [Authentification](https://platform.claude.com/docs/fr/manage-claude/admin-api#authentication) pour plus de détails. Les organisations Claude Enterprise utilisent à la place une clé API Analytics avec une API différente ; consultez [De quelle API avez-vous besoin ?](https://platform.claude.com/docs/fr/manage-claude/usage-cost-api#which-api-do-you-need). **Claude Platform sur AWS :** les points de terminaison programmatiques de l'API d'utilisation et de coûts ne sont pas disponibles actuellement. Consultez plutôt les données d'utilisation et de coûts sur les pages **Usage** et **Cost** de la Claude Console. ## De quelle API avez-vous besoin ? Anthropic fournit des rapports de coûts et d'utilisation via deux API, selon le produit Claude que votre organisation gère : | Votre organisation | API | Type de clé | | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | Claude Console (Claude Platform) | L'API Admin d'utilisation et de coûts décrite sur cette page | Clé API Admin (`sk-ant-admin01-...`) ou un autre [identifiant de l'API Admin](https://platform.claude.com/docs/fr/manage-claude/admin-api#authentication) | | Claude Enterprise (claude.ai) | Les points de terminaison de coûts et d'utilisation de l'[API Analytics Claude Enterprise](https://platform.claude.com/docs/fr/api/beta/organization/analytics) | Clé API Analytics | Les organisations parentes Claude Enterprise n'apparaissent pas dans la Claude Console et ne disposent d'aucune clé API Admin ; pour elles, la clé API Analytics est donc le seul moyen d'accéder à ces données. Consultez [API Analytics](https://platform.claude.com/docs/fr/manage-claude/analytics-api) pour savoir comment créer chaque type de clé et à quels forfaits s'appliquent les données de coûts Claude Enterprise. ## Solutions partenaires Les principales plateformes d'observabilité proposent des intégrations prêtes à l'emploi pour surveiller l'utilisation et les coûts de votre API Claude, sans écrire de code personnalisé. Ces intégrations fournissent des tableaux de bord, des alertes et des analyses pour vous aider à gérer efficacement votre utilisation de l'API. Plateforme d'intelligence cloud pour le suivi et la prévision des coûts Observabilité des LLM avec traçage et surveillance automatiques Intégration sans agent pour une observabilité des LLM simplifiée avec des tableaux de bord et des alertes prêts à l'emploi Plateforme FinOps pour la gestion des coûts du cloud et de l'IA Requêtes et visualisations avancées via OpenTelemetry Attribution de l'utilisation et des coûts aux éléments de travail Jira Plateforme FinOps pour l'observabilité des coûts et de l'utilisation des LLM ## Démarrage rapide Obtenez l'utilisation quotidienne de votre organisation pour les 7 derniers jours : ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-08T00:00:00Z&\ ending_at=2025-01-15T00:00:00Z&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` **Définissez un en-tête User-Agent pour les intégrations** Si vous développez une intégration, définissez votre en-tête User-Agent pour aider Anthropic à comprendre les schémas d'utilisation : ```text wrap User-Agent: YourApp/1.0.0 (https://yourapp.com) ``` ## API d'utilisation Suivez la consommation de tokens dans l'ensemble de votre organisation avec des ventilations détaillées par modèle, espace de travail et niveau de service grâce au point de terminaison `/v1/organizations/usage_report/messages`. ### Concepts clés * **Intervalles de temps :** agrégez les données d'utilisation par intervalles fixes (`1m`, `1h` ou `1d`). * **Suivi des tokens :** mesurez les tokens d'entrée non mis en cache, les tokens d'entrée mis en cache, les tokens de création de cache et les tokens de sortie. * **Filtrage et regroupement :** filtrez par clé API, espace de travail, modèle, niveau de service, « context window » (fenêtre de contexte), [résidence des données](https://platform.claude.com/docs/fr/manage-claude/data-residency) ou vitesse, et regroupez les résultats selon ces dimensions. * **Utilisation des outils serveur :** suivez l'utilisation des outils côté serveur tels que la recherche web. Pour le détail complet des paramètres et les schémas de réponse, consultez la [référence de l'API d'utilisation](https://platform.claude.com/docs/fr/api/beta/organization/usage_report/retrieve_messages). ### Exemples de base #### Utilisation quotidienne par modèle ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-08T00:00:00Z&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` #### Utilisation horaire avec filtrage ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-15T00:00:00Z&\ ending_at=2025-01-15T23:59:59Z&\ models[]=claude-opus-5-5&\ service_tiers[]=batch&\ context_window[]=0-200k&\ bucket_width=1h" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` #### Filtrer l'utilisation par clés API et espaces de travail ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-08T00:00:00Z&\ api_key_ids[]=apikey_01Rj2N8SVvo6BePZj99NhmiT&\ api_key_ids[]=apikey_01ABC123DEF456GHI789JKL&\ workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\ workspace_ids[]=wrkspc_01XYZ789ABC123DEF456MNO&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Pour récupérer les identifiants des clés API de votre organisation, utilisez le point de terminaison [List API Keys](https://platform.claude.com/docs/fr/api/organization/api_keys/list). Pour récupérer les identifiants des espaces de travail de votre organisation, utilisez le point de terminaison [List Workspaces](https://platform.claude.com/docs/fr/api/organization/workspaces/list), ou trouvez-les dans la Claude Console. #### Résidence des données Suivez vos [contrôles de résidence des données](https://platform.claude.com/docs/fr/manage-claude/data-residency) en regroupant et en filtrant l'utilisation avec la dimension `inference_geo`. Cela est utile pour vérifier le routage géographique dans l'ensemble de votre organisation. ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ group_by[]=inference_geo&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Vous pouvez également filtrer sur une zone géographique spécifique. Les valeurs valides sont `global`, `us` et `not_available` : ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ inference_geos[]=us&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Les modèles publiés avant février 2026 (antérieurs à Claude Opus 4.6 et Claude Sonnet 4.6) ne prennent pas en charge le paramètre de requête `inference_geo` ; leurs rapports d'utilisation renvoient donc `"not_available"` pour cette dimension. Vous pouvez utiliser `not_available` comme valeur de filtre dans `inference_geos[]` pour cibler ces modèles. #### Mode rapide Suivez l'utilisation du [mode rapide](https://platform.claude.com/docs/fr/build-with-claude/fast-mode) en regroupant et en filtrant avec la dimension `speed`. Cela est utile pour surveiller l'utilisation en mode standard par rapport au mode rapide. ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ group_by[]=speed&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Vous pouvez également filtrer sur une vitesse spécifique. Les valeurs valides sont `standard` et `fast` : ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ speeds[]=fast&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` ### Limites de granularité temporelle | Granularité | Limite par défaut | Limite maximale | Cas d'utilisation | | ----------- | ----------------- | ----------------- | ------------------------------- | | `1m` | 60 intervalles | 1 440 intervalles | Surveillance en temps réel | | `1h` | 24 intervalles | 168 intervalles | Schémas quotidiens | | `1d` | 7 intervalles | 31 intervalles | Rapports hebdomadaires/mensuels | ## API de coûts Récupérez des ventilations de coûts par service en USD grâce au point de terminaison `/v1/organizations/cost_report`. ### Concepts clés * **Devise :** tous les coûts sont en USD, exprimés sous forme de chaînes décimales dans la plus petite unité (cents). * **Types de coûts :** suivez les coûts d'utilisation des tokens, de la recherche web et de l'exécution de code. * **Regroupement :** regroupez les coûts par espace de travail ou par description pour des ventilations détaillées. Lors d'un regroupement par `description`, les réponses incluent des champs analysés tels que `model` et `inference_geo`. * **Intervalles de temps :** granularité quotidienne uniquement (`1d`). Pour le détail complet des paramètres et les schémas de réponse, consultez la [référence de l'API de coûts](https://platform.claude.com/docs/fr/api/beta/organization/cost_report/retrieve). Les coûts du niveau Priority Tier utilisent un modèle de facturation différent et ne sont pas inclus dans le point de terminaison de coûts. Suivez plutôt l'utilisation du Priority Tier via le point de terminaison d'utilisation. ### Exemple de base ```bash cURL curl "https://api.anthropic.com/v1/organizations/cost_report?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-31T00:00:00Z&\ group_by[]=workspace_id&\ group_by[]=description" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` ## Pagination Les deux points de terminaison prennent en charge la pagination pour les grands ensembles de données : 1. Effectuez votre requête initiale. 2. Si `has_more` vaut `true`, utilisez la valeur `next_page` dans votre requête suivante. 3. Continuez jusqu'à ce que `has_more` vaille `false`. ```bash cURL # Première requête curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-31T00:00:00Z&\ limit=7" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" # La réponse inclut : "has_more": true, "next_page": "page_xyz..." # Requête suivante avec pagination curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-31T00:00:00Z&\ limit=7&\ page=page_xyz..." \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` ## Cas d'utilisation courants Explorez des implémentations détaillées dans le [Claude Cookbook](https://platform.claude.com/cookbook) : * **Rapports d'utilisation quotidiens :** suivez les tendances de consommation de tokens. * **Attribution des coûts :** répartissez les dépenses par espace de travail pour la refacturation interne. * **Efficacité du cache :** mesurez et optimisez la mise en cache des prompts. * **Surveillance budgétaire :** configurez des alertes pour les seuils de dépenses. * **Export CSV :** générez des rapports pour les équipes financières. ## Foire aux questions ### Quelle est la fraîcheur des données ? Les données d'utilisation et de coûts apparaissent généralement dans les 5 minutes suivant la fin d'une requête API, bien que les délais puissent parfois être plus longs. ### Quelle est la fréquence d'interrogation recommandée ? L'API prend en charge une interrogation une fois par minute pour une utilisation soutenue. Pour de courtes rafales (par exemple, le téléchargement de données paginées), une interrogation plus fréquente est acceptable. Mettez en cache les résultats pour les tableaux de bord nécessitant des mises à jour fréquentes. ### Comment suivre l'utilisation de l'exécution de code ? Les coûts d'exécution de code apparaissent dans le point de terminaison de coûts, regroupés sous `Code Execution Usage` dans le champ de description. L'exécution de code n'est pas incluse dans le point de terminaison d'utilisation. ### Comment suivre l'utilisation du Priority Tier ? Filtrez ou regroupez par `service_tier` dans le point de terminaison d'utilisation et recherchez la valeur `priority`. Les coûts du Priority Tier ne sont pas disponibles dans le point de terminaison de coûts. ### Que se passe-t-il avec l'utilisation du playground ? L'utilisation de l'API depuis le playground de la Claude Console (et depuis l'ancien Workbench avant lui) n'est pas associée à une clé API ; `api_key_id` vaudra donc `null` même lors d'un regroupement selon cette dimension. ### Comment l'espace de travail par défaut est-il représenté ? L'utilisation et les coûts attribués à l'espace de travail par défaut ont une valeur `null` pour `workspace_id`. ### Comment obtenir des ventilations de coûts par utilisateur pour Claude Code ? Utilisez l'[API Analytics Claude Code](https://platform.claude.com/docs/fr/manage-claude/claude-code-analytics-api), qui fournit des coûts estimés par utilisateur et des indicateurs de productivité sans les limitations de performance liées à la ventilation des coûts sur de nombreuses clés API. Pour une utilisation générale de l'API avec de nombreuses clés, utilisez l'[API d'utilisation](https://platform.claude.com/docs/fr/manage-claude/usage-cost-api#usage-api) pour suivre la consommation de tokens comme indicateur de coût. ## Voir aussi Utilisez les API d'utilisation et de coûts pour offrir une meilleure expérience à vos utilisateurs, gérer les coûts et préserver votre limite de débit. Apprenez-en davantage sur certaines de ces autres fonctionnalités : * [API Admin](https://platform.claude.com/docs/fr/manage-claude/admin-api) * [Référence de l'API Admin](https://platform.claude.com/docs/fr/api/beta/organization) * [API Analytics](https://platform.claude.com/docs/fr/manage-claude/analytics-api) - Quelle API d'analyse et quel type de clé votre organisation nécessite * [Tarification](https://platform.claude.com/docs/fr/about-claude/pricing) * [Mise en cache des prompts](https://platform.claude.com/docs/fr/build-with-claude/prompt-caching) - Optimisez les coûts grâce à la mise en cache * [Traitement par lots](https://platform.claude.com/docs/fr/build-with-claude/batch-processing) - 50 % de réduction sur les requêtes par lots * [Limites de débit](https://platform.claude.com/docs/fr/api/rate-limits) - Comprendre les niveaux d'utilisation * [API des limites de débit](https://platform.claude.com/docs/fr/manage-claude/rate-limits-api) - Consultez vos limites de débit configurées * [Résidence des données](https://platform.claude.com/docs/fr/manage-claude/data-residency) - Contrôlez la géographie de l'inférence