Migrer l’API Claude vers Fable 5.1 ou Opus 5.5 : les ruptures

Pour la plupart des intégrations, vers Opus 5.5. Depuis le 22 septembre 2026, la vue d’ensemble des modèles d’Anthropic conseille de commencer par Opus 5.5 et de ne passer à Fable 5.1 que pour le raisonnement exigeant et le travail agentique de long horizon, ou quand vos évaluations sur Opus 5.5 à effort élevé restent insuffisantes. Opus 5.5 coûte 4 $ / 20 $ par million de tokens contre 10 $ / 50 $.

Bonne nouvelle pour la migration : les trois ruptures de Fable 5.1 s’appliquent aussi à Opus 5.5. Un code rendu compatible avec l’un l’est presque avec l’autre, et vous pourrez router entre les deux sans réécriture. Les arguments de coût et de qualité sont détaillés dans notre comparatif Opus 5, Opus 5.5 et Fable 5.1, et la fiche du modèle dans notre analyse de Claude Fable 5.1.

Sur Fable 5.1 comme sur Opus 5.5, « tool_choice » n’accepte plus que « auto », le défaut, et « none ». Les valeurs « any » et « tool » renvoient une erreur 400 avec le message « tool_choice: type “tool” and “any” are not supported for this model ». La même vérification s’applique au point de terminaison de comptage de tokens.

La raison : la réflexion est toujours active sur ces modèles, et un appel d’outil forcé la contournerait. Le modèle écrirait alors son raisonnement dans les arguments de l’outil, au détriment de leur qualité.

Trois remplacements, selon votre besoin réel. Pour obtenir du JSON conforme à un schéma, gardez « auto » et déclarez l’outil avec « strict: true », ou passez aux sorties structurées ; le guide de migration précise que dans une organisation CMEK, ces deux options ne sont pas disponibles sur les modèles Fable. Pour que le modèle appelle un outil plutôt que de répondre en texte, nommez l’outil dans l’instruction : la documentation indique que Fable 5.1 suit fiablement ces consignes. Et si c’est votre application qui exige un appel précis sur ce tour, ajoutez un message système en cours de conversation après le dernier message utilisateur : les tours précédents restent intacts et gardent leur cache.

Chaque bloc de réflexion enregistre le modèle qui l’a produit, et chaque modèle ne lit que certains blocs. Fable 5.1 lit les blocs des modèles antérieurs, dont Opus 5 et Fable 5, et, sur la Claude API, ceux d’Opus 5.5. Aucun modèle antérieur ne lit les blocs de Fable 5.1 ; seul Mythos 5.1 fait exception. Opus 5.5 lit les blocs d’Opus 5 et des Opus, Sonnet et Haiku antérieurs, mais pas ceux des modèles Fable ou Mythos.

En pratique, une conversation qui monte d’Opus 5.5 vers Fable 5.1 garde son raisonnement ; une conversation qui redescend le perd pour les tours suivants. Ce second cas arrive sans que vous le décidiez : bascule de routeur, nouvelle tentative sur un autre modèle, ou repli après un refus de classifieur.

L’API retire les blocs illisibles avant que le modèle les voie, la requête réussit, et ces tokens ne sont pas facturés. Le modèle cible repart sans ce raisonnement, ce qui peut augmenter le coût et la latence du premier tour après la bascule. Avec l’en-tête bêta « thinking-binding-controls-2026-08-01 », la réponse liste chaque bloc retiré dans « input_transformations » ; sans lui, la suppression est silencieuse. Si vous exploitez un routeur multi-modèles, activez-le.

C’est le changement qui touche le plus d’intégrations. Un bloc de réflexion produit par Fable 5.1 ou Opus 5.5 n’est valide que tant que le prompt système, les outils et les messages qui le précèdent restent identiques octet pour octet. Si l’un des trois change, la requête suivante renvoie une erreur 400 indiquant « The block is bound to a different conversation ».

Anthropic l’explique dans l’annonce de Fable 5.1 : c’est une mesure contre la distillation. Une technique documentée consistait à modifier le contexte antérieur d’une conversation pour extraire le raisonnement du modèle. Ce n’est donc pas une régression temporaire à contourner, mais la nouvelle norme, reprise telle quelle sur Opus 5.5. Mythos 5.1 n’applique pas ce contrôle.

Oui s’il a été créé le 31 août 2026 ou après : le contrôle y est appliqué par défaut, sur la Claude API comme sur les plateformes cloud. Pour un compte plus ancien, l’API enregistre l’incohérence mais n’agit que si la requête définit « thinking.block_binding.prefix_mismatch_behavior », ce qui revient à activer le contrôle volontairement.

Deux conséquences pratiques. Un code qui passe aujourd’hui sur un compte ancien peut casser chez un client au compte récent : si vous publiez un outil ou un framework que d’autres exécutent avec leur propre clé, testez avec le contrôle activé. Et rendez votre code compatible maintenant : Anthropic a appliqué la même règle à Opus 5.5 trois semaines après Fable 5.1.

Ce qui reste permis : un historique strictement additif, le retrait des blocs de réflexion en tête de série (du plus ancien au plus récent), le changement d’effort entre deux requêtes, le déplacement des marqueurs de cache, et la compaction ou l’édition de contexte côté serveur, qui ne comptent pas comme des modifications.

Un piège à retenir : retirer un bloc de réflexion ailleurs qu’en tête de série invalide tous les blocs suivants. Depuis septembre, deux bêtas facilitent le mode additif : la compaction à la demande (« compact-2026-09-04 »), qui peut garder valides les blocs des tours conservés, et la définition d’un outil directement dans un message (« inline-tools-2026-09-15 »).

Étape 1 : capturez les corps de requête exacts sur quelques tours normaux, avec une compaction et un changement d’outil si votre produit en fait. Pour chaque paire de requêtes consécutives, comparez le prompt système, le tableau d’outils et le préfixe des messages : ils doivent être identiques octet pour octet jusqu’aux tours ajoutés.

Étape 2 : lancez une session multi-tours avec l’en-tête « thinking-binding-controls-2026-08-01 » et « prefix_mismatch_behavior » réglé sur « drop_block », en journalisant « input_transformations » à chaque réponse. Un tableau vide à chaque tour signifie que l’historique est intact. Le motif « prefix_binding_mismatch » signale une modification en amont du bloc ; « model_binding_mismatch » signale une bascule de modèle, pas un bug de votre code.

Étape 3 : choisissez un réglage de production. Laissez l’erreur si une incohérence ne peut venir que d’un bug chez vous, ou « drop_block » pour retirer les blocs concernés plutôt qu’échouer, et surveillez les deux cas. En intégration continue, gardez l’erreur pour qu’une modification fasse échouer le build. Une intégration qui invalide le raisonnement à chaque requête redémarre aussi le cache de prompt à chaque fois, ce qui peut faire grimper le coût par tâche.

Ceux-là ne renvoient aucune erreur : ils dégradent en silence le coût ou l’expérience.

Moins d’appels d’outils en parallèle : dans les boucles longues, Fable 5.1 peut émettre un appel par tour là où Fable 5 en groupait plusieurs, ce qui coûte des tokens, des allers-retours et du temps, sans baisser la qualité. Une instruction de regroupement d’une phrase, ajoutée à chaque tour, corrige le problème. Moins de messages de progression : réglez l’affichage de la réflexion sur « updates » (bêta) pour recevoir ces messages en texte, et retirez toute consigne demandant de garder les observations pour la fin.

Moins de recherche à effort faible : le modèle répond plus souvent de mémoire. Si votre produit dépend de la recherche, montez l’effort pour ces tours ou dites explicitement au modèle quand chercher. L’effet sur un contenu éditorial est détaillé dans notre guide pour utiliser Claude en SEO et en GEO. Sur Opus 5.5, le point équivalent est son effort par défaut à « medium » : fixez-le explicitement.

Appliquez tout ce qui précède, puis ces points, valables vers Fable 5.1 comme vers Opus 5.5 sauf mention contraire.

La réflexion ne se désactive plus : Opus 5 l’acceptait jusqu’à l’effort « high », Fable 5.1 et Opus 5.5 renvoient une erreur 400 à tous les niveaux. Retirez le champ, contrôlez la dépense par un effort plus bas, et revoyez le nombre maximal de tokens. Le texte entre deux appels d’outils revient désormais dans des blocs de réflexion, vides avec l’affichage par défaut : une interface qui affichait cette narration devient muette tant que « display » n’est pas réglé.

Les classifieurs s’élargissent : Opus 5.5 ajoute la biologie à la cybersécurité, et Fable 5.1 reprend les catégories de Fable 5. Côté coût et données, les deux cibles divergent. Vers Fable 5.1, le prix double (10 $ / 50 $) et la rétention de 30 jours devient obligatoire, sauf autorisation expresse d’Anthropic : une organisation en zéro rétention reçoit une erreur 400. Vers Opus 5.5, le prix baisse (4 $ / 20 $), la zéro rétention reste possible, et l’outil « computer_20251124 » doit être remplacé par « computer_toolset_20260801 » sur la Claude API et Google Cloud.

Continuez à lire le motif d’arrêt avant le contenu : une requête refusée renvoie un HTTP 200 avec un « stop_reason » de type refus. Avec le repli par défaut (« fallbacks: “default” », en bêta), la requête est rejouée sur le modèle qu’Anthropic recommande pour la catégorie concernée. Pour Fable 5.1, les cibles autorisées sont Opus 4.8 et Opus 5, qui ne reçoivent pas ses blocs de réflexion.

La facturation a changé le 24 septembre 2026. Un refus arrivé avant toute réponse est désormais facturé lorsqu’il relève d’une catégorie où les faux positifs sont rares ; auparavant, il ne l’était pas. Un refus en cours de réponse facture l’entrée et la sortie déjà produite. Sur Fable 5.1, le crédit de repli rembourse le coût de cache lié au changement de modèle. Une intégration qui relance en boucle une requête refusée paie donc chaque tentative : limitez les relances.

D’abord les deux points qui provoquent des erreurs 400 en production. Changez l’identifiant vers « claude-opus-5-5 » ou « claude-fable-5-1 » ; pour Fable 5.1, vérifiez l’éligibilité de votre organisation à la rétention de 30 jours. Remplacez tout forçage d’outil, et retirez toute désactivation de la réflexion si vous venez d’Opus 5.

Ensuite, la construction des messages. Renvoyez les blocs de réflexion inchangés à chaque tour, y compris vides. Si votre code construit le tableau de messages, faites le test en trois étapes et corrigez chaque incohérence. Rendez l’historique strictement additif : prompt système et outils figés au démarrage, changements passés par des messages système, fichiers référencés par identifiant.

Enfin, les réglages. Fixez l’effort explicitement, surtout sur Opus 5.5. Ajoutez l’instruction de regroupement des appels d’outils, réglez l’affichage de la réflexion si votre interface montre la narration, configurez le repli et limitez les relances après refus. Refaites un balayage d’effort et recalculez le coût sur vos propres charges, par exemple avec le calculateur de coût IA. La chronologie des prochaines sorties est tenue dans notre suivi des nouveaux modèles IA.

Sources consultées le 4 octobre 2026 : nouveautés de Fable 5.1 ; guide de migration vers Fable 5.1 ; nouveautés d’Opus 5.5 ; guide de migration vers Opus 5.5 ; réflexion préservée ; refus et repli ; rétention des données ; vue d’ensemble des modèles ; annonce de Fable 5.1 ; annonce d’Opus 5.5.

Mise à jour du 4 octobre 2026 : ajout d’Opus 5.5 comme cible de migration, facturation des refus depuis le 24 septembre, nouvelles bêtas de compaction et d’outils, messages d’erreur exacts. Aucun comportement décrit ici n’a été mesuré par nos soins sur un compte de production : ce sont les comportements documentés par Anthropic, à revérifier après chaque mise à jour de la documentation.