Note de l’auteur : cet article s’appuie sur la documentation officielle d’Anthropic du 2026-11-08 (UTC+8) et sur le guide des paramètres thinking de Claude d’APIYI, mis à jour le 2026-11-09 à 10:40. La date de vérification des spécifications est le 2026-11-13. Il vous aide à éviter les erreurs 400 liées au paramètre thinking sur claude-opus-5-5 et claude-sonnet-5-5.
Si vous passez le type de thinking à disabled sur claude-opus-5-5, l’API renvoie directement une erreur 400 — c’est ce que précise noir sur blanc la documentation officielle d’Anthropic du 2026-11-08 (UTC+8). APIYI (apiyi.com) a actualisé et synchronisé le guide des paramètres thinking de Claude le 2026-11-09 à 10:40, clarifiant la bonne façon d’écrire les deux ID de modèle. Cet article décrypte rapidement l’impact de ce changement pour les appelants de l’API Claude.
Ce ne sont pas des rumeurs : les deux conclusions clés s’appuient sur la documentation — claude-opus-5-5 ne peut pas désactiver la réflexion, on peut seulement réduire effort ; pour claude-sonnet-5-5, désactiver la réflexion préalable nécessite de passer par between_tools.
Valeur essentielle : comprenez en 3 minutes la bonne façon d’écrire les deux ID de modèle, les limites du paramètre between_tools, ainsi que la démarche de diagnostic des erreurs 400.
Aperçu des informations clés : le paramètre thinking de claude-opus-5-5 et claude-sonnet-5-5
D’abord le tableau de conclusions, puis les détails un par un :
| Élément | Détails |
|---|---|
| Position officielle | Documentation officielle Anthropic du 2026-11-08 (UTC+8) |
| Mise à jour du guide APIYI | 2026-11-09 10:40, docs.apiyi.com synchronisé |
| claude-opus-5-5 | Sans thinking, le modèle passe en réflexion adaptative ; avec disabled, l’API renvoie 400 |
| claude-sonnet-5-5 | Sans thinking, également en réflexion adaptative ; pour couper la réflexion préalable, utiliser between_tools |
Valeur par défaut de effort |
medium pour Opus 5.5, high pour Sonnet 5.5 |
| Sortie maximale | 128000 pour les deux identifiants de modèle, les tokens de réflexion y sont inclus |
Le paramètre de claude-opus-5-5 est assez direct. Si la requête ne contient pas le champ thinking, le modèle entre en réflexion adaptative : c’est lui qui décide, pour chaque appel, s’il réfléchit et jusqu’où il pousse la réflexion. En revanche, dès qu’on règle le type de thinking sur disabled, l’interface ne l’ignore pas en silence : elle renvoie directement une erreur 400. Autrement dit, cet identifiant de modèle n’a pas d’interrupteur pour couper la réflexion, et le seul levier prévu par la documentation consiste à abaisser effort, dont le niveau par défaut est medium.
La situation de claude-sonnet-5-5 est un peu différente. Il prend lui aussi en charge la réflexion adaptative quand thinking est absent, mais il dispose en plus d’une voie de désactivation officiellement reconnue : régler type sur between_tools coupe la réflexion préalable et ne conserve que les mises à jour de progression entre les appels d’outils. Les limites de cette voie sont tout aussi explicites, mieux vaut donc se référer directement au tableau ci-dessous :
| Contrainte | Ce que dit la documentation |
|---|---|
Valeurs de effort |
uniquement low, medium, high |
| Plafond du niveau | ne peut pas dépasser high |
| Combinaisons interdites | impossible de l’accompagner de display ou de budget_tokens |
| Effet réel | la réflexion préalable est coupée, seules les mises à jour de progression entre les appels d’outils sont conservées |
Il y a aussi un détail qui passe facilement inaperçu : les tokens de réflexion sont décomptés dans max_tokens. La sortie maximale des deux identifiants de modèle est de 128000, et si la requête fixe un max_tokens trop bas, la réflexion risque de consommer la majeure partie du budget, ce qui tronque ensuite le corps de la réponse. Quand on cherche pourquoi « les réponses raccourcissent sans raison », cela vaut la peine de vérifier d’abord la part occupée par la réflexion.
Légende : le chemin d’appel illustré prend pour exemple la passerelle au format natif Anthropic d’APIYI apiyi.com. En format Anthropic, l’adresse de base est https://api.apiyi.com — attention, il ne faut pas l’écrire avec /v1.
Analyse d’impact : les erreurs 400 de disabled et les appelants concernés
Ce changement de convention touche les appelants sur trois points : le traitement des erreurs, les combinaisons de paramètres et la planification du budget. En décomposant chaque point, ce sera plus parlant.
Impact sur le code existant : migrer les écritures disabled
| Scénario | Ancienne écriture | Résultat actuel | Bonne pratique |
|---|---|---|---|
| claude-opus-5-5 veut désactiver la réflexion | type = disabled |
renvoie une erreur 400 | Désactivation impossible, seul moyen : baisser effort |
| claude-sonnet-5-5 veut désactiver la réflexion préalable | type = disabled |
renvoie une erreur 400 | Passer à between_tools |
| Contrôle fin du budget de réflexion | between_tools avec budget_tokens |
Combinaison refusée | Les deux ne peuvent pas être transmis ensemble, utiliser les trois niveaux d’effort |
| Crainte que la réflexion empiète sur la sortie | max_tokens réglé très bas |
Le texte de sortie est tronqué | La réflexion compte dans max_tokens, prévoir une marge |
Premier impact : les contraintes sur les combinaisons de paramètres se multiplient. between_tools ne peut pas coexister avec budget_tokens ni avec display, ce qui signifie que le contrôle fin du budget de réflexion ne fonctionne plus par cette voie : il faut passer par les trois niveaux low, medium et high pour ajuster les choses indirectement. Ajoutez à cela la règle « les tokens de réflexion comptent dans max_tokens », et l’appelant doit retrouver un nouvel équilibre entre effort et max_tokens.
Deuxième impact : la logique de branchement est à mettre à jour. Si un script décide de transmettre ou non disabled selon l’ID du modèle, il doit prévoir une branche pour ces deux ID : le premier accepte la réalité du « on ne peut pas désactiver » et baisse effort d’un cran ; le second bascule sur between_tools. Regrouper ce type de branches dans une configuration unique permet de limiter la surface de modification quand la convention évoluera encore.
Au passage, la même page précise que Fable 5.1 et Fable 5 renvoient eux aussi une erreur 400 avec disabled : là non plus, pas moyen de désactiver. Haiku 5.5 et Opus 5, en revanche, acceptent toujours disabled tant que effort ne dépasse pas high. Si le code sert plusieurs ID de modèles à la fois, mieux vaut maintenir une matrice d’activation par modèle plutôt que d’appliquer la même écriture partout.
Impact sur la structure des coûts : tokens de réflexion et consommation
Sur la grille tarifaire globale d’APIYI (apiyi.com), claude-sonnet-5-5 est facturé $2 en entrée, $10 en sortie et $0.1 en lecture de cache. Comme les tokens de réflexion sont comptés dans max_tokens, le fait de désactiver ou non la réflexion préalable et le palier d’effort choisi se répercutent directement sur la consommation de tokens. Dans les scénarios d’appels à haute fréquence, cet écart prend de l’ampleur ; quand vous modifiez le code, ça vaut le coup de faire le calcul au passage.
Légende : données consolidées à partir de la documentation officielle du 2026-11-08 ; vous pouvez les vérifier en les comparant à l’original dans le centre de documentation d’APIYI apiyi.com.
| ID du modèle | Disponibilité de disabled |
Référence dans la documentation |
|---|---|---|
| claude-opus-5-5 | Non disponible, renvoie 400 | Impossible de désactiver la réflexion ; on peut seulement réduire effort (valeur par défaut medium) |
| claude-sonnet-5-5 | Non disponible, renvoie 400 | Utiliser plutôt between_tools (valeur par défaut high) |
| Fable 5.1 / Fable 5 | Non disponible, renvoie 400 | Impossible de la désactiver également |
| Haiku 5.5 / Opus 5 | Disponible lorsque effort n’est pas supérieur à high |
L’ancienne syntaxe ne fonctionne que sur ces deux ID |
Comment vérifier rapidement between_tools sur claude-sonnet-5-5
Avant de déployer une modification, il est conseillé de valider d’abord les différences de comportement avec un faible volume. Inscrivez-vous sur APIYI (apiyi.com) et obtenez une clé API : les nouveaux utilisateurs disposent de crédits de test gratuits. Envoyez la requête à https://api.apiyi.com, définissez type de thinking sur between_tools dans le corps de la requête, choisissez l’un des trois niveaux pour effort, lancez d’abord une exécution, puis comparez avec le mode adaptatif sans thinking pour observer l’évolution de la structure de sortie et de la consommation de tokens.
🚀 Conseil de validation rapide : obtenez des crédits de test gratuits via APIYI apiyi.com, exécutez le même ensemble d’invites en mode
between_toolset en mode adaptatif, puis modifiez le code existant une fois les différences confirmées. La plateforme prend en charge les appels unifiés aux principaux modèles tels que Claude, OpenAI et Gemini ; l’interface compatible OpenAI est facturée à l’usage, ce qui facilite la comparaison et le basculement.
FAQ : disabled, between_tools et erreurs 400
Q1 : Peut-on vraiment désactiver la réflexion sur claude-opus-5-5 ?
Non. La documentation officielle du 08/11/2026 indique clairement que passer `disabled` renvoie une erreur 400 : cet ID de modèle ne propose pas d’option pour désactiver la réflexion. On peut uniquement réduire la profondeur de réflexion via `effort`, dont le niveau par défaut est `medium`. Si votre cas d’usage exige une absence totale de réflexion, il faut changer d’ID de modèle.
Q2 : Peut-on combiner between_tools et budget_tokens sur claude-sonnet-5-5 ?
Non. La documentation précise explicitement que `between_tools` ne peut pas être accompagné de `display` ni de `budget_tokens`, et que le `effort` correspondant n’accepte que les trois niveaux `low`, `medium` et `high`, sans pouvoir dépasser `high`. Pour contrôler finement le budget de réflexion, il faut revenir au mode adaptatif ou changer d’ID de modèle.
Q3 : Pourquoi ma requête Claude renvoie-t-elle soudainement une erreur 400 ?
Vérifiez d’abord si `type` de `thinking` est défini sur `disabled` dans le corps de la requête : sur claude-opus-5-5 et claude-sonnet-5-5, il s’agit de la condition de déclenchement documentée. Après vérification, appliquez le tableau de correspondance de cet article : pour le premier, réduisez `effort` ; pour le second, passez à `between_tools`. Les formulations applicables font référence à la documentation officielle du 08/11/2026 (UTC+8) ; la page APIYI a été synchronisée le 09/11/2026 à 10:40.
Q4 : Comment vérifier rapidement l’effet de between_tools sur claude-sonnet-5-5 ?
Inscrivez-vous sur APIYI (apiyi.com) et obtenez une clé API : les nouveaux utilisateurs disposent de crédits de test gratuits. Envoyez la requête à `https://api.apiyi.com`, définissez `type` de `thinking` sur `between_tools`, choisissez l’un des niveaux pour `effort`, puis lancez une exécution pour comparer avec le mode adaptatif.
Q5 : Les tokens de réflexion peuvent-ils empiéter sur le budget de sortie ?
Oui. Les tokens de réflexion sont comptés dans `max_tokens`, et la sortie maximale des deux ID de modèle est de 128 000. Si `max_tokens` est défini trop bas dans la requête, la réflexion peut consommer le budget en premier et tronquer le contenu de la réponse. Il est recommandé de prévoir suffisamment d’espace pour la réponse.
claude-opus-5-5 et claude-sonnet-5-5 : les points clés (Key Takeaways)
- claude-opus-5-5 : impossible de désactiver la réflexion : passer
disabledrenvoie directement une erreur 400, seuleffortpermet de réduire le niveau, avecmediumpar défaut. - claude-sonnet-5-5 passe à
between_tools: désactive la réflexion préalable et ne conserve que les mises à jour de progression entre les appels d’outils. - Trois lignes rouges sur les paramètres :
effortn’accepte quelow,mediumethigh, sans dépasserhigh, et il est interdit de le combiner avecdisplayetbudget_tokens. - Règle de budget : les tokens de réflexion sont comptés dans
max_tokens, la limite pour les deux ID étant de 128000. - Point d’accès pour vérifier : APIYI apiyi.com, la base au format Anthropic est
https://api.apiyi.com, sans ajouter/v1.
En résumé : trois gestes pour éviter le 400
Le comportement de claude-opus-5-5 et de claude-sonnet-5-5 se résume en trois phrases :
- claude-opus-5-5 : passer
disabledprovoque un 400, la réflexion ne peut pas être désactivée, seul abaissereffortest possible. - claude-sonnet-5-5 : pour désactiver la réflexion préalable, utilisez
between_tools, trois niveaux deeffort, et aucune combinaison avecdisplaynibudget_tokens. - Budget : les tokens de réflexion sont comptés dans
max_tokens, plafond à 128000, en gardant une marge pour le texte principal.
Si ce 400 vous bloque, je vous conseille de passer d’abord par APIYI apiyi.com avec le quota de test gratuit pour faire un tour de between_tools, confirmer le comportement, puis modifier votre code existant. Sur la plateforme, une seule clé API suffit pour appeler les grands modèles courants comme OpenAI, Claude ou Gemini, avec une facturation à l’usage, ce qui est idéal pour comparer et basculer rapidement.
📚 Références
- Guide des paramètres de réflexion Claude d’APIYI : les bonnes manières d’utiliser
effortetthinking - Lien :
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
Description : version mise à jour le 2026-11-09 à 10h40, principale source factuelle de cet article
-
Actualités des mises à jour du guide APIYI : explication officielle de la synchronisation de cette itération
- Lien :
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
Description : documente le processus d’alignement avec la documentation officielle du 2026-11-08
-
Documentation officielle d’Anthropic : formulation d’origine du paramètre
thinking - Lien :
docs.anthropic.com - Description : lecture comparative recommandée pour confirmer la dernière formulation
Auteur : équipe technique d’APIYI
Échanges techniques : n’hésitez pas à nous contacter depuis la page d’accueil du site APIYI ; d’autres ressources sont disponibles au centre de documentation docs.apiyi.com
