API d'utilisation et de coûts

L'API d'administration Usage & Cost offre 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 dans les pages Usage et Cost de la Claude Console.

Cette API vous permet de mieux surveiller, analyser et optimiser vos implémentations Claude :

• Suivi précis de l'utilisation : Obtenez des décomptes de tokens et des modèles d'utilisation précis au lieu de vous fier uniquement au comptage des tokens de réponse
• Rapprochement des coûts : Faites correspondre les enregistrements internes avec la facturation Anthropic pour les équipes financières et comptables
• Performance et amélioration du produit : Surveillez les performances du produit tout en mesurant si les modifications apportées au système l'ont amélioré, ou configurez des alertes
• Optimisation de la limite de débit et du Priority Tier : Optimisez des fonctionnalités comme la mise en cache des prompts ou des prompts spécifiques pour tirer le meilleur parti de votre capacité allouée, ou achetez de la capacité dédiée.
• Analyse avancée : Effectuez une analyse de données plus approfondie que ce qui est disponible dans la Console

Les organisations Claude Enterprise utilisent une clé API Analytics avec une API différente ; consultez De quelle API avez-vous besoin ?.



De quelle API avez-vous besoin ?

Anthropic fournit des rapports de coûts et d'utilisation via deux API, selon le produit Claude que gère votre organisation :

Les organisations parentes Claude Enterprise n'apparaissent pas dans la Claude Console et ne disposent pas de clés API Admin ; pour elles, la clé API Analytics est donc le seul moyen d'accéder à ces données. Consultez API Analytics 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 votre utilisation et vos coûts de l'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.



Démarrage rapide

Obtenez l'utilisation quotidienne de votre organisation pour les 7 derniers jours :

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

User-Agent: YourApp/1.0.0 (https://yourapp.com)



API d'utilisation

Suivez la consommation de tokens dans 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 temporels : Agrégez les données d'utilisation dans des intervalles fixes (1m, 1h ou 1d)
• Suivi des tokens : Mesurez les tokens d'entrée non mis en cache, d'entrée mis en cache, de création de cache et de sortie
• Filtrage et regroupement : Filtrez par clé API, espace de travail, modèle, niveau de service, fenêtre de contexte, résidence des données ou vitesse (bêta), et regroupez les résultats selon ces dimensions
• Utilisation des outils serveur : Suivez l'utilisation des outils côté serveur comme la recherche web

Pour les détails complets des paramètres et les schémas de réponse, consultez la référence de l'API d'utilisation.



Exemples de base



Utilisation quotidienne par modèle

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Utilisation horaire avec filtrage

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-4-8&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Filtrer l'utilisation par clés API et espaces de travail

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Résidence des données

Suivez vos contrôles de résidence des données en regroupant et en filtrant l'utilisation avec la dimension inference_geo. Ceci est utile pour vérifier le routage géographique dans votre organisation.

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "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 :

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Mode rapide (aperçu de recherche)

Suivez l'utilisation du mode rapide en regroupant et en filtrant avec la dimension speed. Ceci est utile pour surveiller l'utilisation du mode standard par rapport au mode rapide.

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "anthropic-beta: fast-mode-2026-02-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Vous pouvez également filtrer sur une vitesse spécifique. Les valeurs valides sont standard et fast :

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "anthropic-beta: fast-mode-2026-02-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Limites de granularité temporelle



API de coûts

Récupérez les ventilations de coûts au niveau du service en USD avec le point de terminaison /v1/organizations/cost_report.



Concepts clés

• Devise : Tous les coûts sont en USD, rapportés sous forme de chaînes décimales dans les plus petites unités (cents)
• Types de coûts : Suivez les coûts d'utilisation des tokens, de recherche web et d'exécution de code
• Regroupement : Regroupez les coûts par espace de travail ou par description pour des ventilations détaillées. Lors du regroupement par description, les réponses incluent des champs analysés comme model et inference_geo
• Intervalles temporels : Granularité quotidienne uniquement (1d)

Pour les détails complets des paramètres et les schémas de réponse, consultez la référence de l'API de coûts.



Exemple de base

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "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 est true, utilisez la valeur next_page dans votre requête suivante
3. Continuez jusqu'à ce que has_more soit false

# 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" \
  --header "anthropic-version: 2023-06-01" \
  --header "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..." \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Cas d'usage courants

Explorez des implémentations détaillées dans le Claude Cookbook :

• Rapports d'utilisation quotidiens : Suivez les tendances de consommation de tokens
• Attribution des coûts : Allouez les dépenses par espace de travail pour la refacturation
• Efficacité du cache : Mesurez et optimisez la mise en cache des prompts
• Surveillance du budget : Configurez des alertes pour les seuils de dépenses
• Export CSV : Générez des rapports pour les équipes financières



Questions fréquentes



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 de la requête API, bien que les délais puissent occasionnellement être plus longs.



Quelle est la fréquence d'interrogation recommandée ?

L'API prend en charge une interrogation 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 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.



Qu'en est-il de l'utilisation du Workbench ?

L'utilisation de l'API depuis le Workbench n'est pas associée à une clé API, donc api_key_id sera null même lors du regroupement par 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, qui fournit des coûts estimés par utilisateur et des métriques de productivité sans les limitations de performance liées à la ventilation des coûts par de nombreuses clés API. Pour une utilisation générale de l'API avec de nombreuses clés, utilisez l'API d'utilisation pour suivre la consommation de tokens comme indicateur de coût.



Voir aussi

Les API d'utilisation et de coûts peuvent vous aider à offrir une meilleure expérience à vos utilisateurs, à gérer vos coûts et à préserver votre limite de débit. En savoir plus sur certaines de ces autres fonctionnalités :

• API Admin
• Référence de l'API Admin
• API Analytics - Quelle API d'analyse et quel type de clé votre organisation nécessite
• Tarification
• Mise en cache des prompts - Optimisez les coûts avec la mise en cache
• Traitement par lots - 50 % de réduction sur les requêtes par lots
• Limites de débit - Comprendre les niveaux d'utilisation
• API des limites de débit - Consultez vos limites de débit configurées
• Résidence des données - Contrôlez la géographie d'inférence