L'ESSENTIEL EN 30 SECONDES

  • Avec 2026-10-21, envoyer temperature, top_p ou top_k à l'API Messages renvoie une erreur 400, même avec les valeurs par défaut.
  • Les nouvelles versions majeures comprennent Python 2.0.0, TypeScript 1.0.0, Go 2.0.0, Java 3.0.0 et C# 13.0.0, sous licence Apache 2.0.
  • Il reste possible de rester sur 2023-06-01 ; aucune date de fin n'a été annoncée.

Anthropic a mis en ligne le 21 octobre une nouvelle version de l'API Claude, la première modification de l'en-tête anthropic-version depuis 2023-06-01. Elle arrive avec de nouvelles versions majeures de tous les SDK officiels et de l'outil en ligne de commande ant, qui envoient la nouvelle version par défaut.

Ce qui casse dans l'API Messages

Le changement le plus visible touche l'échantillonnage. Les requêtes contenant temperature, top_p ou top_k sont désormais refusées avec une erreur 400, y compris lorsque ces paramètres ont leur valeur par défaut. Le guide de migration souligne que le code qui abaissait la température pour obtenir des réponses plus constantes perd cet effet et qu'aucun réglage ne le remplace ; les équipes qui en ont besoin doivent conserver ces appels sur l'ancienne version.

Deux règles de structure se durcissent aussi. Un bloc document ne peut plus figurer directement dans un message de l'assistant, et les blocs de texte côté utilisateur ne peuvent plus porter de tableau citations non vide. Les API Admin et Enterprise Analytics renomment plusieurs champs : par exemple, workspace_id devient un objet scope sur les clés d'API.

Les SDK et la CLI

D'après les notes de version, les nouvelles moutures sont Python 2.0.0, TypeScript 1.0.0, C# 13.0.0, Go 2.0.0, Java 3.0.0, PHP 1.0.0, Ruby 2.0.0 et la CLI ant 2.0.0. Certains changements s'appliquent quelle que soit la version d'API : les clés sont désormais transmises via Authorization: Bearer au lieu de X-Api-Key, ce qui concerne les proxys et les filtres de journaux ; un client ne peut plus détenir qu'un seul identifiant ; l'ancienne interface Text Completions disparaît de plusieurs SDK ; et le type Python MessageParam est scindé selon le rôle. Les SDK passent en outre de la licence MIT à Apache 2.0.

Que faire ?

La migration se fait sur adhésion. En appel direct, la version se choisit par l'en-tête ; avec un SDK, il suffit de passer à la nouvelle version majeure. Anthropic recommande de tester contre 2026-10-21 et de livrer la mise à jour du SDK en même temps que les correctifs. Sur Amazon Bedrock, la nouvelle version ne fonctionne qu'avec Claude 4.7 et les modèles ultérieurs.

Le guide ne fixe aucune date de retrait pour 2023-06-01 : il n'y a donc pas d'échéance immédiate. La suppression des réglages d'échantillonnage est le changement le plus susceptible d'exiger une décision produit plutôt qu'un simple correctif, notamment pour les applications qui misaient sur une faible température pour obtenir des réponses reproductibles.