Présentation de l'API

L'API Claude est une API RESTful accessible à 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 aurez besoin de :

• Un compte Claude Console
• Une clé API, ou une règle 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 :

Disponibilité générale :

• API Messages : envoyez des messages à Claude pour des interactions conversationnelles (POST /v1/messages)
• API Message Batches : traitez de grands volumes de requêtes Messages de manière asynchrone avec une réduction de coût de 50 % (POST /v1/messages/batches)
• API Token Counting : comptez les tokens d'un message avant l'envoi pour gérer les coûts et les limites de débit (POST /v1/messages/count_tokens)
• API Models : listez les modèles Claude disponibles et leurs détails (GET /v1/models)

Bêta :

• API Files : téléversez et gérez des fichiers à utiliser dans plusieurs appels d'API (POST /v1/files, GET /v1/files)
• API Skills : créez et gérez des compétences d'agent personnalisées (POST /v1/skills, GET /v1/skills)
• API Agents : définissez des configurations d'agent réutilisables et versionnées pour les Claude Managed Agents (POST /v1/agents, GET /v1/agents)
• API Sessions : exécutez des sessions d'agent avec état dans des sandboxes cloud gérés (POST /v1/sessions, GET /v1/sessions/{id}/stream)
• API Environments : configurez des modèles de sandbox pour les sessions d'agent (POST /v1/environments, GET /v1/environments)

Pour la référence complète de l'API avec tous les points de terminaison, paramètres et schémas de réponse, explorez les pages de référence de l'API répertorié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 les deux méthodes d'authentification et savoir quand utiliser chacune, consultez Authentification. Toutes les requêtes à l'API Claude doivent inclure ces en-têtes :

Si vous utilisez les SDK clients, le SDK enverra ces en-têtes automatiquement. Pour plus de détails sur le versionnement de l'API, consultez Versions de l'API.

Lorsque vous accédez à 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. Vous pouvez utiliser le Workbench pour tester l'API dans le navigateur, puis générer des clés API dans les Paramètres du compte. Utilisez les espaces de travail pour segmenter vos clés API 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 (x-api-key, anthropic-version, content-type)
• Gestion typée des requêtes et des réponses
• 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 une liste des SDK clients, consultez SDK clients.



API Claude vs plateformes cloud

Claude est disponible via l'API Claude directe et via des plateformes cloud. Choisissez en fonction de votre infrastructure, de la disponibilité des fonctionnalités, de vos 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 : les nouvelles intégrations, l'accès complet aux fonctionnalités, une relation directe avec Anthropic



API des plateformes cloud

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

• Intégration avec 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 et Microsoft Foundry ; les plateformes exploitées par des partenaires incluent Amazon Bedrock et Vertex AI. Consultez la page de chaque plateforme pour connaître la disponibilité et le calendrier des fonctionnalités.
• Idéal pour : les engagements cloud existants, les exigences de conformité spécifiques, la facturation cloud consolidée



Format des requêtes et des réponses



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 chaque réponse :

• request-id : un identifiant globalement unique pour la requête
• anthropic-organization-id : l'ID d'organisation associé à la clé API utilisée dans la requête



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 niveaux d'utilisation qui augmentent automatiquement à mesure que vous utilisez l'API. Chaque niveau 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 les limites actuelles de votre organisation dans la Console. Pour des limites plus élevées ou le Priority Tier (niveaux de service améliorés avec dépenses engagées), contactez l'équipe commerciale via la Console.

Pour des informations détaillées sur les limites, les niveaux 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.



Étapes suivantes