API Claude : la version 2026-10-21 supprime la température et change l'authentification des SDK

Jusqu'ici, les SDK d'Anthropic envoyaient tous le même en-tête de version avec chaque requête : 2023-06-01. L'éditeur documente maintenant le passage à 2026-10-21. Le point à retenir pour une équipe : on ne choisit pas forcément cette version, on la reçoit en mettant à jour son SDK.

Comment on bascule, parfois sans le vouloir

Un SDK envoie la version d'API qui était en vigueur à la sortie de sa version majeure. Les premières versions à envoyer 2026-10-21 sont, selon le guide de migration :

• Python : anthropic 2.0.0 ;
• TypeScript : @anthropic-ai/sdk 1.0.0 ;
• Go : 2.0.0, avec un nouveau chemin de module en /v2 et Go 1.25 au minimum ;
• Java : 3.0.0 ; C# : 13.0.0 ; PHP : 1.0.0 ; Ruby : 2.0.0 ;
• l'outil en ligne de commande ant : 2.0.0.

Sans SDK, c'est l'en-tête anthropic-version qui décide. Une montée de version majeure dans un fichier de dépendances suffit donc à changer le comportement de l'API.

Trois requêtes qui renvoient maintenant une erreur 400

• Les paramètres d'échantillonnage. temperature, top_p et top_k sont refusés, même à leur valeur par défaut. Les SDK ne les proposent plus.
• Un bloc document placé directement dans un message de l'assistant. Les documents s'envoient dans les messages de l'utilisateur.
• Des citations sur un bloc de texte dans un message de l'utilisateur.

Le premier point est le plus sensible. Les modèles Claude 4.7 et suivants n'acceptaient déjà que les valeurs par défaut : rien ne change pour eux. En revanche, sur un modèle comme Claude Sonnet 4.6, une application qui baissait la température pour obtenir des réponses plus régulières perd cet effet. Le guide est explicite : aucun autre réglage ne le remplace. Il reste deux options, retirer le paramètre ou laisser cette requête sur 2023-06-01.

L'authentification change dans les SDK

Les SDK et ant envoient désormais la clé d'API dans l'en-tête Authorization: Bearer au lieu de X-Api-Key. L'API accepte les deux. Le risque est ailleurs : un proxy, une passerelle, un filtre de journaux ou un test qui lit X-Api-Key ne verra plus rien.

Autre conséquence : un client ne porte plus qu'un seul identifiant. Passer à la fois une clé et un jeton lève une erreur dans la plupart des SDK. Et les options --api-key et --auth-token de ant disparaissent, car une valeur en ligne de commande reste visible dans l'historique du shell.

Ce qui disparaît aussi

• L'ancienne API Text Completions est retirée des SDK TypeScript, Go, Java et Ruby et de ant.
• Plusieurs champs de l'Admin API sont renommés.
• La licence des SDK passe de MIT à Apache 2.0. Aucun code à changer, mais un inventaire de licences à mettre à jour.

Le cas Amazon Bedrock

Sur Bedrock, 2026-10-21 n'est disponible que pour Claude 4.7 et les modèles suivants. Pour un modèle plus ancien, Anthropic demande de rester sur la version de SDK actuelle, ou de changer d'abord de modèle.

Ce que le guide ne dit pas

La page que nous avons lue ne donne aucune date de fin pour 2023-06-01, ni la durée pendant laquelle les anciennes versions majeures des SDK recevront des correctifs.

Notre lecture

Pour une petite équipe, le danger n'est pas la migration elle-même mais la migration involontaire : un outil de mise à jour automatique des dépendances qui propose la version majeure, une fusion rapide, et des erreurs 400 en production. Trois vérifications avant d'accepter :

1. Chercher temperature, top_p et top_k dans le code et dans les bibliothèques qui appellent Claude à votre place.
2. Vérifier ce que vos proxys et vos journaux font de l'en-tête X-Api-Key.
3. Épingler la version majeure du SDK tant que les tests n'ont pas tourné contre 2026-10-21.