Référence de l'APISupport et configuration
Versions
Lorsque vous effectuez des requêtes API, vous devez envoyer un en-tête de requête anthropic-version. Par exemple, anthropic-version: 2026-10-21. Si vous utilisez les SDK clients, cela est géré automatiquement pour vous.
Pour toute version donnée de l’API, Anthropic préserve :
- Les paramètres d’entrée existants
- Les paramètres de sortie existants
Cependant, Anthropic peut effectuer les actions suivantes :
- Ajouter des entrées optionnelles supplémentaires
- Ajouter des valeurs supplémentaires à la sortie
- Modifier les conditions pour des types d’erreurs spécifiques
- Ajouter de nouvelles variantes aux valeurs de sortie de type énumération (par exemple, les types d’événements de streaming)
En général, si vous utilisez l’API telle que documentée dans cette référence, Anthropic ne perturbera pas votre utilisation.
Historique des versions
Anthropic recommande d’utiliser la dernière version de l’API dans la mesure du possible.
2026-10-21- Migrer vers la version d’API 2026-10-21 explique comment effectuer la mise à niveau.
- Disponible sur l’API Claude, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Microsoft Foundry et Claude Models on Google Cloud (Google managed). Sur Amazon Bedrock, elle est disponible pour Claude 4.7 et les modèles ultérieurs. Pour les autres modèles sur Bedrock, consultez le guide de migration vers la version 2026-10-21 de l’API.
- API Messages :
- Une requête qui place un bloc
documentdirectement dans un messageassistantrenvoie une erreur 400. - L’envoi d’un bloc
textavec un tableaucitationsnon vide dans un messageuser, directement ou à l’intérieur d’un blocsearch_result, renvoie une erreur 400. - Les paramètres de requête
temperature,top_pettop_ksont supprimés. Une requête qui envoie l’un d’entre eux renvoie une erreur 400 sur tous les modèles.
- Une requête qui place un bloc
- Admin API :
- Les groupes RBACAperç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. ne renvoient plus
roles. Utilisezrole_idsà la place. - Les membres de groupes RBACAperç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., ainsi que la réponse à la suppression de l’un d’entre eux, ne renvoient plus
group_id. Utilisezrbac_group_idà la place. - Les rôles RBACAperç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. ne renvoient plus
name. Utilisezdisplay_nameà la place. - Les entrées de « rate limit » (limite de débit) de l’organisationAperç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. et de l’espace de travailAperç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., ainsi que la réponse à la définition des limites de débit d’un espace de travailAperç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., ne renvoient plus
group_type. Utilisezgroup.typeà la place. - Les clés 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. ne renvoient plus
workspace_id. Utilisezscope.workspace_idà la place, qui fournit l’ID réel de l’espace de travail, même pour l’espace de travail par défaut (une clé valable pour tous les espaces de travail n’a pas deworkspace_iddansscope).
- Les groupes RBACAperç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. ne renvoient plus
- Claude Enterprise Analytics API :
- Les rapports d’utilisationAperç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. et de coûtAperç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. par utilisateur n’ont plus
actor.email. Utilisezactor.email_addressà la place. - La réponse des résumés d’activitéAperç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. n’a plus
summaries. Utilisezdataà la place.
- Les rapports d’utilisationAperç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. et de coûtAperç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. par utilisateur n’ont plus
2023-06-01- Nouveau format pour les « server-sent events » (événements envoyés par le serveur), ou SSE, en streaming :
- Les complétions sont incrémentales. Par exemple,
" Hello"," my"," name"," is"," Claude."au lieu de" Hello"," Hello my"," Hello my name"," Hello my name is"," Hello my name is Claude.". - Tous les événements sont des événements nommés, plutôt que des événements contenant uniquement des données.
- Suppression de l’événement inutile
data: [DONE].
- Les complétions sont incrémentales. Par exemple,
- Suppression des valeurs héritées
exceptionettruncateddans les réponses.
- Nouveau format pour les « server-sent events » (événements envoyés par le serveur), ou SSE, en streaming :
2023-01-01: Version initiale.
Cette page vous a-t-elle été utile ?