Référence de l'APIUtiliser l'API

Aperçu de l’API

Copy page



Comprenez les points de terminaison disponibles de l’API Claude, les en-têtes d’authentification, les SDK clients, la pagination, les limites de débit et les options d’accès aux plateformes cloud.

L’API Claude est une API RESTful à l’adresse https://api.anthropic.com qui fournit un accès programmatique aux modèles Claude et aux Claude Managed Agents.

Prérequis

Pour utiliser l’API Claude, vous avez besoin de :

• Un compte Claude Console
• Une clé API provenant de la Console, ou une règle de Workload Identity Federation configurée

Pour des instructions de configuration étape par étape, consultez Démarrer.

API disponibles

L’API Claude comprend les API suivantes :

• Messages APIAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir. : Envoyez des messages à Claude pour des interactions conversationnelles (POST /v1/messages).
• Message Batches APIAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir. : Traitez de grands volumes de requêtes Messages de manière asynchrone avec une réduction de coût de 50 pour cent (POST /v1/messages/batches).
• Token Counting APIAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir. : Comptez les tokens d’un message avant de l’envoyer afin de gérer les coûts et les limites de débit (POST /v1/messages/count_tokens).
• Models APIAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir. : Listez les modèles Claude disponibles et leurs détails (GET /v1/models).
• Files APIAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir. : Téléversez et gérez des fichiers à utiliser dans plusieurs appels API (POST /v1/files, GET /v1/files).
• Skills APIAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir. : Créez et gérez des compétences d’agent personnalisées (POST /v1/skills, GET /v1/skills).

Les API suivantes sont en bêta :

• Agents API : Définissez des configurations d’agent réutilisables et versionnées pour Claude Managed Agents (POST /v1/agents, GET /v1/agents).
• Sessions API : Exécutez des sessions d’agent avec état dans des bacs à sable cloud gérés (POST /v1/sessions, GET /v1/sessions/{id}/events/stream).
• Environments API : Configurez des modèles de bac à sable pour les sessions d’agent (POST /v1/environments, GET /v1/environments).

Pour la référence API complète avec tous les points de terminaison, paramètres et schémas de réponse, explorez les pages de référence API listées dans la navigation. Pour accéder aux fonctionnalités bêta, consultez En-têtes bêta.

Authentification

Pour plus de détails sur chaque méthode d’authentification et quand l’utiliser, consultez Authentification. Les requêtes vers l’API Claude incluent ces en-têtes :

Si vous utilisez les SDK clients, le SDK envoie automatiquement les en-têtes d’authentification, de version et de content-type ; vous transmettez vous-même anthropic-workspace-id lorsque votre clé en a besoin. Pour plus de détails sur le versionnage de l’API, consultez Versions de l’API.

Lors de l’accès à Claude via une plateforme cloud, l’authentification est intégrée au système IAM du fournisseur cloud. Consultez la documentation spécifique à la plateforme pour connaître les types d’identifiants pris en charge, les en-têtes requis et les options d’authentification.

Obtenir des clés API

L’API est mise à disposition via la Console web. Dans la Console, vous pouvez utiliser le Playground (platform.claude.com/playground) pour essayer l’API dans le navigateur, puis générer des clés API sur la page Clés API (platform.claude.com/settings/keys). Pour savoir comment procéder, consultez Obtenir votre clé API Claude. Vous choisissez le type de chaque clé (consultez Types de clés) et son expiration lors de sa création. Utilisez les espaces de travail dans la Console pour séparer les environnements et contrôler les dépenses par cas d’usage.

SDK clients

Anthropic fournit des SDK officiels qui simplifient l’intégration de l’API en gérant l’authentification, le formatage des requêtes, la gestion des erreurs, et plus encore.

Avantages :

• Gestion automatique des en-têtes (authentification, anthropic-version, content-type)
• Gestion des requêtes et réponses avec typage sûr
• Logique de nouvelle tentative et gestion des erreurs intégrées
• Prise en charge du streaming
• Délais d’expiration des requêtes et gestion des connexions

Pour la liste des SDK clients, consultez SDK, CLI et bibliothèques.

API Claude ou plateformes cloud

Claude est disponible via l’API Claude propriétaire et via les plateformes cloud. Choisissez en fonction de votre infrastructure, de la disponibilité des fonctionnalités, des exigences de conformité et de vos préférences tarifaires.

API Claude

• Accès direct aux derniers modèles et fonctionnalités
• Facturation et support Anthropic
• Idéal pour : Nouvelles intégrations, accès complet aux fonctionnalités, relation directe avec Anthropic

API des plateformes cloud

Accédez à Claude via AWS, Google Cloud ou Microsoft Azure :

• Intégré à la facturation et à l’IAM du fournisseur cloud
• La disponibilité des fonctionnalités varie selon la plateforme : Les plateformes exploitées par Anthropic incluent Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) et Microsoft Foundry ; les plateformes exploitées par des partenaires incluent Claude Models on Google Cloud (Google managed) et Amazon Bedrock. Consultez la page de chaque plateforme pour connaître la disponibilité et le calendrier des fonctionnalités.
• Idéal pour : Engagements cloud existants, exigences de conformité spécifiques, facturation cloud consolidée

Format des requêtes et réponses

Limites de taille des requêtes

L’API Claude propriétaire applique ces limites de taille des requêtes :

Si vous dépassez ces limites, vous recevrez une erreur 413 request_too_large.

En-têtes de réponse

L’API Claude inclut les en-têtes suivants dans ses réponses :

Pour les en-têtes de limite de débit, consultez En-têtes de réponse dans Limites de débit. Pour des exemples qui lisent un en-tête de réponse par son nom avec chaque SDK, consultez Identifier l’espace de travail derrière une réponse API.

Pagination

Les points de terminaison de liste renvoient les résultats par pages. La plupart des points de terminaison de liste plus récents utilisent le schéma de curseur page et next_page décrit dans cette section. Certains utilisent un schéma différent ; consultez la note à la fin de cette section. Utilisez le paramètre de requête limit pour contrôler la taille de la page et le paramètre de requête page pour récupérer une page adjacente. Chaque réponse inclut un tableau data à côté des champs de curseur pour naviguer entre les pages.

Pour revenir à une page précédente, transmettez prev_page comme paramètre page. prev_page est null lorsque vous êtes sur la première page. Tous les points de terminaison de liste ne prennent pas en charge prev_page. Seul GET /v1/sessions renvoie prev_page ; sur les points de terminaison de liste qui ne prennent pas en charge la pagination vers l’arrière, le champ est absent de la réponse plutôt que null. Pour un guide détaillé des requêtes, consultez Lister les sessions.

Le SDK fournit un itérateur à pagination automatique qui suit next_page pour vous. Par exemple, for session in client.beta.sessions.list() parcourt chaque session. La pagination automatique du SDK fonctionne uniquement vers l’avant ; pour revenir à la page précédente, lisez prev_page dans la réponse et retransmettez-le vous-même comme paramètre page. Consultez SDK, CLI et bibliothèques pour plus de détails.

Limites de débit et disponibilité

Limites de débit

L’API applique des limites de débit et des limites de dépenses pour prévenir les abus et gérer la capacité. Les limites sont organisées en paliers d’utilisation ; votre organisation est placée automatiquement sur un palier et peut passer à un palier supérieur au fil du temps. Chaque palier comporte :

• Limites de dépenses : coût mensuel maximal pour l’utilisation de l’API
• Limites de débit : nombre maximal de requêtes par minute (RPM) et de tokens par minute (TPM)

Vous pouvez consulter vos limites de débit sous Limites de débit dans la Claude Console et vos limites de dépenses sur la page Facturation de la Console. Pour obtenir des limites de débit plus élevées ou un plafond de dépenses mensuel plus élevé, utilisez Demander un niveau supérieur sur la page Limites de débit.

Pour des informations détaillées sur les limites, les paliers et l’algorithme du seau à jetons utilisé pour la limitation de débit, consultez Limites de débit.

Disponibilité

L’API Claude est disponible dans de nombreux pays et régions à travers le monde. Consultez la page des régions prises en charge pour confirmer la disponibilité dans votre localisation.

Prochaines étapes