Note de l’auteur : claude-haiku-5-5 réfléchit par défaut, et si vous voulez désactiver cela vous tombez sur une erreur ? C’est le plus souvent parce que effort est supérieur à high. Cet article explique la règle, la correction en trois étapes et les limites des paramètres.
Demander à claude-haiku-5-5 de réfléchir moins et de réserver son quota de sortie au contenu lui-même est une demande très courante quand on fait du traitement par lots ou des tâches structurées. Vous avez peut-être déjà mis thinking à disabled, et l’API vous renvoie une erreur : alors que vous vouliez simplement désactiver la réflexion, pourquoi vous bloque-t-on ? Cet article présente les règles de combinaison entre effort et disabled, pour vous aider à maîtriser rapidement la bonne méthode pour désactiver la réflexion sur claude-haiku-5-5.
Ce n’est ni un problème mystique, ni un caprice du modèle. La documentation est très claire : si vous ne passez pas thinking à claude-haiku-5-5, il utilise la réflexion adaptative, activée par défaut ; pour désactiver la réflexion, on utilise type: disabled dans thinking, mais cette écriture n’est acceptée que lorsque effort n’est pas supérieur à high. Les paramètres de cet article se réfèrent à la documentation officielle Anthropic du 2026-11-08 (UTC+8), vérifiée le 2026-11-13.
L’essentiel : après cette lecture, vous comprendrez la vraie cause de l’erreur, la méthode de correction en trois étapes, ainsi que la relation entre max_tokens et les tokens de réflexion ; ensuite, quel que soit l’environnement dans lequel vous appelez le modèle, cette règle ne vous bloquera plus.
claude-haiku-5-5 : les points essentiels
On commence par les conclusions, pour les lecteurs pressés :
| Point | Ce que dit la doc | Ce que ça change pour vous |
|---|---|---|
| Réflexion activée par défaut | Sans champ thinking, c’est la réflexion adaptative, donc activée |
Pour économiser du quota, il faut la désactiver explicitement |
| Interrupteur de désactivation | thinking défini sur type: disabled |
C’est la seule façon de la couper |
Condition sur effort |
disabled n’est accepté que si effort ne dépasse pas high |
Avec xhigh ou max, la requête renvoie une erreur |
Valeur par défaut de effort |
medium par défaut, comme claude-opus-5-5 |
Tant que vous ne montez pas la valeur, pas de piège |
| Limites de quota | Sortie maximale de 128 000, les tokens de réflexion comptent dans max_tokens |
La réflexion grignote la place du texte final |
claude-haiku-5-5 : le détail des points clés
Premier point : la réflexion est active par défaut. claude-haiku-5-5 est un modèle qui tourne avec la capacité de réflexion par défaut : si le champ thinking n’apparaît pas dans la requête, il fonctionne en réflexion adaptative. La doc ne détaille pas le processus de décision du mode adaptatif, mais une chose est sûre : par défaut, la réflexion est bien activée.
Si votre cas d’usage est du question-réponse court, de l’étiquetage en masse ou de la conversion de format, autrement dit des tâches qui n’ont pas besoin d’un raisonnement poussé, les tokens de réflexion sont une pure dépense. La doc précise aussi que ces tokens comptent dans max_tokens, avec une sortie maximale de 128 000 : plus il y a de réflexion, moins il reste de place pour le corps de la réponse. C’est exactement de là que vient le besoin de « couper la réflexion pour garder le quota pour le texte ».
Deuxième point : la désactivation a ses conditions. Le seul interrupteur pour couper la réflexion consiste à mettre thinking sur type: disabled. Mais la doc précise également que cette écriture n’est acceptée que si effort ne dépasse pas high : avec effort à medium ou high, tout va bien, mais dès qu’on le règle sur xhigh ou max, la requête échoue. La correction officielle est tout aussi simple : redescendre effort à high ou en dessous. Si vous appelez claude-haiku-5-5 via APIYI apiyi.com, c’est également par cette combinaison de paramètres qu’il faut commencer le diagnostic de ce type d’erreur.
Troisième point : la valeur par défaut est justement la plus sûre. Chez claude-haiku-5-5, effort vaut medium par défaut, comme pour claude-opus-5-5, alors que la plupart des autres modèles sont à high. Le scénario qui fait mal, c’est souvent celui-ci : on migre du code depuis un autre modèle, on a l’habitude de pousser effort explicitement sur xhigh ou max pour gagner en qualité, et on ajoute disabled au passage pour maîtriser les coûts. Les deux intentions se contredisent, et l’erreur arrive.
À l’inverse, il suffit de ne pas monter effort : le medium par défaut satisfait naturellement la condition « pas plus de high », et disabled s’applique correctement. Quand on veut comparer plusieurs modèles entre eux, appeler plusieurs modèles avec une seule clé API sur APIYI apiyi.com évite aussi de refaire sa configuration d’accès à chaque fois.
Le schéma ci-dessus montre le chemin de diagnostic standard ; le cas le plus fréquent reste bloqué sur la case de décision du milieu : effort hors limites. Après correction, je conseille de valider d’abord avec un petit quota sur APIYI apiyi.com pour vérifier que la réponse revient normalement, avant de l’envoyer dans le trafic de production.
Il semble que le contenu source à traduire n’ait pas été inclus dans votre message — je vois uniquement les consignes de traduction, mais aucun article chinois à traiter.
Pouvez-vous me coller le texte technique original (l’article sur claude-haiku-5-5, ou tout autre contenu) ? Dès que je l’ai, je produis la version française en respectant :
- la structure Markdown existante (titres, tableaux, listes, blocs de code) ;
- la conservation stricte des identifiants techniques (
claude-haiku-5-5,model,thinking,effort,{"type": "disabled"},max_tokens,https://api.apiyi.com/v1, etc.) ; - la traduction des commentaires et docstrings en français dans les blocs de code ;
- les termes du glossaire (APIYI, grand modèle de langage, invite, clé API, service proxy API, invocation du modèle, etc.) ;
- les mentions de marque (APIYI, apiyi.com) laissées telles quelles ;
- les placeholders SVG (
{{SVG_TEXT_N}}) préservés à l’identique ; - un style naturel et conversationnel, sans front matter YAML en tête.
Envoyez-moi le texte et je m’en occupe.
Compatibilité de l’effort avec claude-haiku-5-5
Le tableau ci-dessous est le plus important à retenir de tout l’article ; je vous conseille de l’enregistrer directement dans les notes de votre équipe :
| Valeur d’effort | Combinaison avec disabled |
Résultat |
|---|---|---|
medium (par défaut) |
Compatible | Désactive normalement la réflexion |
high |
Compatible | Désactive normalement la réflexion |
xhigh |
Conflit | La requête renvoie une erreur |
max |
Conflit | La requête renvoie une erreur |
En comparant ce tableau avec vos propres requêtes, la direction à suivre devient évidente : si une erreur apparaît dans une requête qui transmet aussi disabled, le premier réflexe est de vérifier si effort a dépassé la limite high. La seule solution de correction documentée tient en une phrase : ramener effort à high ou moins ; il n’existe aucun autre contournement.
Effort par défaut : claude-haiku-5-5 et les autres modèles
| Modèle | Effort par défaut | Relation avec la désactivation de la réflexion |
|---|---|---|
| claude-haiku-5-5 | medium |
Satisfait par défaut à « pas plus de high » ; disabled peut prendre effet directement |
| claude-opus-5-5 | medium |
Valeur par défaut identique à celle de haiku ; les règles d’activation et de désactivation de sa réflexion ne sont pas détaillées ici |
| La plupart des autres modèles | high |
La valeur par défaut reste elle aussi sous le seuil ; seule une augmentation manuelle la fait dépasser |
Ce tableau explique « pourquoi c’est précisément ma requête qui échoue » : la valeur effort par défaut varie selon les modèles. Lors d’une migration de code, on garde facilement les anciennes habitudes de paramétrage et on fixe explicitement effort à xhigh ou max. Comparer les valeurs par défaut avant une migration est la prévention la moins coûteuse.
Dépannage des erreurs claude-haiku-5-5 et liste de vérification
| Symptôme | Cause la plus probable | Solution |
|---|---|---|
Vous passez disabled et l’erreur persiste |
effort vaut xhigh ou max |
Descendez effort à high ou moins |
Vous ne savez pas quelle valeur d’effort utiliser |
En l’absence de valeur, la valeur par défaut est medium |
La valeur par défaut satisfait à la condition, aucune action supplémentaire n’est nécessaire |
| Le texte de réponse raccourcit ou est tronqué | Les tokens de réflexion sont comptés dans max_tokens |
Désactivez la réflexion ou augmentez max_tokens dans la limite de 128000 |
| Vous voulez une meilleure qualité de raisonnement | La réflexion désactivée ne produit aucun processus de réflexion | Retirez disabled et revenez à la réflexion adaptative par défaut |
Une fois les corrections effectuées, parcourez cette liste de vérification avant d’envoyer la requête :
modelest bien écritclaude-haiku-5-5effortest omis, ou explicitement défini surmediumouhighthinkingvaut{"type": "disabled"}max_tokensne dépasse pas 128000
Si les quatre conditions sont remplies, ce type d’erreur ne reviendra plus. Fixez la combinaison finale de paramètres dans un modèle de requête pour éviter les modifications accidentelles par la suite.
FAQ – Questions fréquentes sur claude-haiku-5-5
Q1 : claude-haiku-5-5 réfléchit-il par défaut ?
Oui. D’après la documentation, si vous ne passez pas `thinking`, claude-haiku-5-5 fonctionne en réflexion adaptative, activée par défaut. Pour réserver tout le quota de sortie au texte de réponse, il faut transmettre explicitement `disabled` pour la désactiver.
Q2 : pourquoi une erreur même avec disabled ?
La cause la plus fréquente est un `effort` supérieur à `high`. La documentation précise que `disabled` n’est accepté que si `effort` ne dépasse pas `high` : avec `xhigh` ou `max`, ça renvoie une erreur. Le correctif consiste à redescendre `effort` à `high` ou en dessous.
Q3 : que se passe-t-il si on ne passe pas effort ?
La valeur par défaut est `medium`. claude-haiku-5-5 et claude-opus-5-5 partagent la même valeur par défaut, `medium`, alors que la plupart des autres modèles utilisent `high`. Cette valeur par défaut satisfait déjà la condition « ne pas dépasser high », donc vous pouvez l’associer directement à `disabled`.
Q4 : une fois la réflexion désactivée, qu’est-ce qui change pour la longueur de sortie ?
La documentation indique que les tokens de réflexion sont comptés dans `max_tokens`, avec une sortie maximale de 128000. Une fois la réflexion désactivée, le même budget `max_tokens` peut être entièrement consacré au texte de réponse, et le risque de troncature diminue d’autant.
Q5 : comment obtenir ponctuellement un raisonnement plus poussé ?
Il suffit de retirer `disabled` pour que claude-haiku-5-5 revienne à sa réflexion adaptative par défaut. Si vous voulez aussi augmenter `effort`, attention à ne pas rester coincé sur la combinaison « `xhigh` ou `max` avec `disabled` ».
Q6 : comment vérifier rapidement que le correctif est bien pris en compte ?
Après inscription sur APIYI apiyi.com, vous obtenez un crédit de test gratuit ; utilisez l’adresse `https://api.apiyi.com/v1` et relancez une requête avec les paramètres corrigés : si elle ne renvoie plus d’erreur et que le texte de réponse revient normalement, c’est que `disabled` est bien appliqué. La plateforme facture à l’usage, donc une petite vérification coûte très peu.
Q7 : l’erreur vient-elle forcément de effort ?
Pas forcément, mais c’est un cas explicitement documenté. Vérifiez d’abord que `model` est bien écrit `claude-haiku-5-5`, puis contrôlez si la combinaison `thinking` / `effort` sort des limites autorisées, et seulement ensuite cherchez d’autres causes. Si vous rencontrez une erreur en passant par APIYI, commencez de la même façon par examiner ce couple de paramètres.
Q8 : sur quelle version se basent ces règles pour les paramètres ?
Cet article s’appuie sur la documentation officielle Anthropic au 2026-11-08 (UTC+8), vérifiée le 2026-11-13. Si Anthropic modifie ensuite les règles liant `effort` et `disabled`, référez-vous à la documentation la plus récente.
Résumé
Désactiver la réflexion de claude-haiku-5-5 repose sur quatre points essentiels :
- Active par défaut : sans transmission de
thinking, le mode adaptatif s’applique et il est activé par défaut. Pour économiser du quota, il faut le désactiver explicitement. - La désactivation a ses conditions : lorsque
thinkingest réglé surdisabled,effortne doit pas dépasserhigh. Associerxhighoumaxdéclenche une erreur. - Les valeurs par défaut sont sûres :
effortvautmediumpar défaut, comme pour claude-opus-5-5. Sans augmentation volontaire, aucun conflit ne se produira. - Limites du quota : la sortie maximale est de 128 000 tokens, les tokens de réflexion sont comptés dans
max_tokens. Une fois la réflexion désactivée, la totalité du quota revient au corps de la réponse.
La prochaine fois que vous tomberez sur « je veux désactiver la réflexion mais ça renvoie une erreur », vérifiez d’abord si effort dépasse la limite high, remettez de l’ordre dans la combinaison de paramètres, et le problème sera en principe résolu. Nous vous recommandons de passer par APIYI apiyi.com pour vérifier rapidement le résultat grâce au quota de test gratuit : une seule clé API suffit pour appeler claude-haiku-5-5 et bien d’autres grands modèles du marché, et l’interface compatible OpenAI facilite aussi le changement de modèle.
📚 Références
- Documentation APIYI : paramètres effort et thinking de Claude
- Lien :
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
Description : valeurs de effort, conditions d’acceptation de disabled et formulation des erreurs
-
Documentation APIYI : mise à jour du guide sur la réflexion de Claude (2026-11)
- Lien :
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
Description : historique des mises à jour et contexte du guide sur la réflexion
-
Documentation officielle Anthropic
- Lien :
docs.anthropic.com - Description : les paramètres de cet article suivent la version officielle du 2026-11-08 (UTC+8)
Auteur : équipe technique APIYI
Échanges techniques : n’hésitez pas à nous contacter depuis la page d’accueil du site APIYI ; vous trouverez davantage de ressources dans le centre de documentation
