Aller au contenu
Cercle IA Tech · API Un site du réseau Cercle IA Tech

Question

L'en-tête anthropic-version : à quoi il sert

L'en-tête anthropic-version est obligatoire sur l'API Claude. Ce que garde chaque version, ce que change la révision du 21/10/2026 et comment migrer.

Mis à jour le

Chaque appel direct à l'API Messages de Claude doit porter un en-tête anthropic-version. Il sélectionne le contrat de version de l’API ; il ne fige pas les réponses du modèle, les tarifs ni toutes les fonctions optionnelles. Vous l'avez croisé dans les exemples du premier appel sous la forme anthropic-version: 2026-10-21, identifiant de la révision datée du 21/10/2026. Cette page explique ce qu'il garantit, ce qu'il ne garantit pas et ce qui change avec la version relevée le 16/11/2026.

Pour intégrer une autre interface, telle que celle décrite dans la documentation API d’ALMA, repartez de son propre contrat. L’en-tête de version Anthropic n’est pas un réglage universel : documentez la politique de compatibilité de chaque service utilisé.

Ce que la documentation garantit

Pour une version d'API donnée, Anthropic indique conserver les paramètres d'entrée existants et les paramètres de sortie existants. Il se réserve toutefois quatre choses :

  • ajouter des entrées facultatives ;
  • ajouter des valeurs dans les réponses ;
  • changer les conditions d'apparition de certains types d'erreur ;
  • ajouter des variantes aux valeurs de type énumération, par exemple de nouveaux types d'événements de streaming.

La page conclut que, si vous utilisez l'API comme elle est documentée, votre usage ne devrait pas casser. Conséquence pour votre code : tolérez les champs inconnus dans une réponse et ne partez pas du principe qu'une liste de valeurs est fermée. Cela vaut aussi pour les codes d'erreur et les raisons d'arrêt.

L'historique des versions

Version Ce que dit la page
2023-01-01 (01/01/2023) Première version
2023-06-01 (01/06/2023) Nouveau format des événements de streaming : complétions incrémentales, événements nommés, suppression de l'événement data: [DONE] ; retrait de valeurs anciennes (exception, truncated)
2026-10-21 (21/10/2026) Version la plus récente relevée, avec des changements dans l'API Messages, l'API d'administration et l'API d'analyse

Anthropic recommande d'utiliser la dernière version dès que possible, et renvoie vers un guide de migration dédié à la révision du 21/10/2026 (identifiant 2026-10-21).

Ce que change la révision du 21/10/2026 pour l'API Messages

Selon la page des versions :

  1. Un bloc document placé directement dans un message assistant renvoie une erreur 400.
  2. Un bloc text avec un tableau citations non vide, dans un message user (directement ou dans un bloc search_result), renvoie une erreur 400.
  3. Les paramètres temperature, top_p et top_k sont retirés : une requête qui en envoie renvoie une erreur 400 sur tous les modèles. Le détail, avec Gemini et Mistral, est sur la page des réglages de température.

L'API d'administration (groupes de droits, clés d'API, limites de débit) et l'API d'analyse pour Claude Enterprise ont aussi des champs renommés ; la page les énumère. Si vous ne les utilisez pas, vous n'êtes pas concerné.

Où cette version est disponible

La page indique que la révision datée du 21/10/2026 (identifiant 2026-10-21) est disponible sur l'API Claude, Claude Platform on AWS, Claude Models on Google Cloud (gérés par Anthropic ou par Google) et Microsoft Foundry. Sur Amazon Bedrock, elle l'est pour Claude 4.7 et les modèles suivants ; pour les modèles plus anciens, la documentation conseille de garder la version utilisée aujourd'hui.

Migrer sans casser

  1. Lisez le guide de migration d'Anthropic avant de changer l'en-tête.
  2. Cherchez dans votre code les trois paramètres retirés et les blocs concernés.
  3. Passez la nouvelle version d'abord dans un environnement de test.
  4. Avec le SDK officiel, vérifiez la version du SDK : c'est lui qui renseigne l'en-tête.

Le sujet voisin, la fin de vie des modèles eux-mêmes, est traité sur le cycle de vie des modèles.

Garder une preuve de migration

Conservez des requêtes représentatives avec leurs réponses attendues : texte simple, outil, document, réponse structurée et flux en continu si vous utilisez ces fonctions. Notez la version du SDK, l’en-tête envoyé et l’identifiant du modèle pour chaque série. Une dépendance mise à jour peut modifier la requête même si votre propre code n’a pas changé.

Après migration, vérifiez à la fois l’absence d’erreur et la lecture correcte des sorties. Un parseur qui ignore un nouveau champ peut rester compatible ; un programme qui traite un nouveau motif d’arrêt comme une réussite peut perdre une information essentielle. Prévoyez une branche pour les valeurs inconnues, avec un diagnostic exploitable.

Questions fréquentes

L'en-tête anthropic-version est-il obligatoire ?

Oui pour un appel direct : la documentation indique qu'il faut envoyer l'en-tête anthropic-version avec chaque requête. Si vous utilisez le SDK officiel, il le renseigne pour vous.

Anthropic peut-il changer la réponse sans prévenir pour une version donnée ?

Il peut ajouter des champs en entrée facultatifs, ajouter des valeurs en sortie, changer les conditions de certains types d'erreur et ajouter des variantes aux valeurs de type énumération. Il conserve les paramètres d'entrée et de sortie existants.

Quelle est la dernière version d'API relevée ?

La révision identifiée `2026-10-21` correspond au 21/10/2026 ; cette version a été relevée le 16/11/2026. Anthropic recommande d'utiliser la dernière version quand c'est possible.

Sources

Pages consultées pour écrire cet article :

  1. https://alma.iarche.fr/fr/api-docs
  2. https://platform.claude.com/docs/en/api/versioning
  3. https://platform.claude.com/docs/en/build-with-claude/working-with-messages

À lire aussi