Claude API 2026-10-21 supprime temperature, top_p et top_k

Anthropic a publié une nouvelle version de l'API Claude, 2026-10-21, le 21 octobre 2026. Elle supprime les paramètres d'échantillonnage temperature, top_p et top_k. Toute requête qui en envoie un échoue désormais avec une erreur 400. Sept SDK officiels et l'outil en ligne de commande ant ont publié de nouvelles versions majeures qui l'utilisent par défaut.

La version précédente, 2023-06-01, était la version par défaut depuis plus de trois ans. La revue quotidienne des outils d'agents de Munder Difflin la décrit comme la première nouvelle version de l'API d'Anthropic depuis.

Comment fonctionnent les versions de l'API Claude

Chaque requête envoyée à l'API Claude porte un en-tête anthropic-version. Sa valeur est une date qui rattache la requête à un ensemble fixe de comportements. Pour utiliser la nouvelle version sans SDK, envoyez anthropic-version: 2026-10-21.

Au sein d'une même version, la page d'Anthropic sur les versions promet que les champs d'entrée et de sortie existants restent tels quels. Anthropic peut tout de même ajouter des entrées facultatives, de nouvelles valeurs de sortie et de nouveaux types d'événements de streaming. Supprimer ou renommer un champ exige une nouvelle version datée, et c'est ce qui s'est passé ici.

Les SDK choisissent la version pour vous. Selon le guide de migration, les requêtes « utilisent la version de l'API qui était en vigueur lors de la sortie de la version majeure de votre SDK ». Le code qui tourne sur une ancienne version majeure d'un SDK continue d'envoyer 2023-06-01 jusqu'à ce que vous le mettiez à jour.

Ce qui ne fonctionne plus dans l'API Messages

Trois formes de requête renvoient désormais une erreur 400, selon les notes de version d'Anthropic :

• Paramètres d'échantillonnage. temperature, top_p et top_k sont supprimés. En envoyer un seul fait échouer la requête, quel que soit le modèle.
• Documents dans les tours de l'assistant. Un bloc document placé directement dans un message assistant est rejeté.
• Citations dans les tours de l'utilisateur. Un bloc text avec un tableau citations non vide dans un message user est rejeté. Cela inclut un tel bloc imbriqué dans un bloc search_result.

L'Admin API renomme aussi plusieurs champs. Les groupes RBAC utilisent role_ids au lieu de roles, et les rôles utilisent display_name au lieu de name. Pour les clés API, workspace_id passe dans scope.workspace_id. Deux champs de Claude Enterprise Analytics changent également : actor.email devient actor.email_address, et summaries devient data.

La nouvelle version fonctionne sur l'API Claude, Claude Platform on AWS, Microsoft Foundry et Google Cloud. Sur Amazon Bedrock, elle ne couvre que Claude 4.7 et les modèles plus récents.

Les nouvelles versions majeures des SDK

Voici les premières versions qui envoient 2026-10-21, d'après les notes de version et le guide de migration :

SDK ou outil	Première version sur 2026-10-21
Python (anthropic)	2.0.0
TypeScript (@anthropic-ai/sdk)	1.0.0
C# (Anthropic)	13.0.0
Go (anthropic-sdk-go/v2)	2.0.0
Java (com.anthropic:anthropic-java)	3.0.0
PHP (anthropic-ai/sdk)	1.0.0
Ruby (gem anthropic)	2.0.0
CLI ant	2.0.0

Les SDK apportent leurs propres changements incompatibles, distincts de la version de l'API. Le guide de migration liste les principaux :

• En-tête d'autorisation. Les SDK et la CLI envoient désormais la clé via Authorization: Bearer, et non X-Api-Key. L'API accepte les deux en-têtes, mais un proxy ou une passerelle qui lit X-Api-Key doit être modifié.
• Un seul identifiant par client. Fournir à la fois une clé API et un jeton d'authentification est désormais une erreur. En Python, cela lève ValueError ; en TypeScript, TypeError.
• Text Completions supprimé. L'ancienne interface de complétions disparaît des SDK TypeScript, Go, Java et Ruby, ainsi que de la CLI. Utilisez l'API Messages.
• Chemin du module Go. Le code Go doit remplacer chaque import par github.com/anthropics/anthropic-sdk-go/v2 et nécessite Go 1.25 ou une version ultérieure.
• Commande de mise à jour PHP. Un simple composer update reste sur l'ancienne version majeure. Utilisez composer require pour passer à la 1.0.0.

La licence change aussi. À partir de ces versions, les SDK et la CLI sont sous licence Apache 2.0 au lieu de MIT. Les versions antérieures restent sous MIT, et le guide précise qu'aucune modification de code n'est nécessaire pour cela.

Plus tard le 21 octobre, Python SDK 2.1.0 et TypeScript SDK 1.1.0 ont ajouté aux profils utilisateur un statut et des actions de mise en application des règles. Il s'agit d'une fonctionnalité distincte, qui ne fait pas partie du changement de version.

Ce que cela signifie pour les développeurs

Rien ne casse tant que vous ne passez pas à une nouvelle version majeure d'un SDK ou ne changez pas l'en-tête vous-même. Cela vous laisse du temps, mais les notes de version n'indiquent aucune date d'arrêt pour 2023-06-01. Planifiez la migration plutôt que d'attendre une telle date.

• Cherchez d'abord les paramètres d'échantillonnage. Trouvez chaque appel qui définit temperature, top_p ou top_k, y compris dans les wrappers et les fichiers de configuration. Chacun deviendra une erreur 400 après la mise à jour.
• Vérifiez ce qui se trouve entre vous et l'API. Un proxy de journalisation, une passerelle ou un scanner de secrets qui lit X-Api-Key ne verra plus la clé dès que le SDK enverra Authorization: Bearer.
• Figez la version majeure dans votre fichier de verrouillage. Une plage de versions non figée pour anthropic ou @anthropic-ai/sdk peut passer à la nouvelle version majeure à la prochaine installation. Faites la mise à jour volontairement, avec des tests.
• Passez en revue les conversations enregistrées. Si vous rejouez des historiques de messages sauvegardés, vérifiez qu'ils ne contiennent pas de documents dans les tours de l'assistant ni de citations dans les tours de l'utilisateur.
• Prévenez la personne chargée des licences. Les nouvelles versions majeures sont sous Apache 2.0, et non sous MIT. Consignez le changement avant le déploiement de la mise à jour.