Claude Platform Docs
Modèles et tarifsClaude Haiku 5.5

Guide de migration vers Claude Haiku 5.5

Passez à Claude Haiku 5.5 depuis des modèles Haiku antérieurs grâce à ce guide de migration. Les instructions pour activer Claude Haiku 5.5 comprennent le nouvel identifiant de modèle, les paramètres qui renvoient des erreurs, les changements liés à la réflexion et une liste de vérification pour chaque modèle de départ.

Claude Code

Laissez Claude Code migrer votre code pour vous

/claude-api migrate ce projet vers claude-haiku-5-5

Ce guide explique comment faire passer du code qui appelle Claude Haiku 4.5 à Claude Haiku 5.5. Pour du code qui appelle Claude Haiku 3.5 ou Claude Haiku 3, effectuez également les modifications décrites dans Migrer vers Claude Haiku 5.5 depuis Claude Haiku 3.5 et les modèles Haiku antérieurs. Pour passer plutôt à un modèle Sonnet ou Opus, consultez Guides de migration. Pour savoir combien de temps Claude Haiku 4.5 reste disponible, consultez Dépréciations de modèles.

Liste de vérification de migration par modèle de départ

Parcourez les groupes dans l’ordre et arrêtez-vous après celui qui mentionne votre modèle actuel. Si vous utilisez Claude Haiku 4.5, le premier groupe constitue la liste complète. Chaque élément correspond à une modification à apporter à votre code.

Tous les modèles de départ

  1. Remplacez l’identifiant de modèle par l’identifiant de Claude Haiku 5.5 pour votre plateforme. Consultez Utiliser l’identifiant de modèle Claude Haiku 5.5.
  2. Recomptez vos prompts et revoyez les limites max_tokens ainsi que les estimations de coûts, car le même texte compte davantage de tokens et les grandes images comptent davantage de tokens visuels. Consultez Recompter les tokens.
  3. Si vos requêtes envoient thinking: {"type": "enabled", "budget_tokens": N}, remplacez thinking par {"type": "adaptive"}. Consultez Configurer la réflexion.
  4. Si votre code lit le premier bloc de contenu comme étant la réponse, sélectionnez plutôt les blocs par type. Consultez Configurer la réflexion.
  5. Supprimez temperature, top_p et top_k de vos requêtes. Consultez Supprimer les paramètres d’échantillonnage.
  6. Si vos requêtes terminent messages par un tour de l’assistant que le modèle doit poursuivre, terminez-les plutôt par un tour de l’utilisateur. Consultez Remplacer le préremplissage de l’assistant.
  7. Si vous utilisez l’utilisation de l’ordinateur, remplacez computer_20250124 par l’ensemble d’outils computer_toolset_20260801. Sur Amazon Bedrock, computer_20251124 fonctionne également. Consultez Passer l’utilisation de l’ordinateur à l’ensemble d’outils.
  8. Si vous rejouez des conversations stockées via un compte différent, rejouez chacune d’elles via le compte qui l’a produite. Consultez Rejouer les blocs de réflexion via le compte qui les a produits.
  9. Si votre code modifie system, tools ou des messages antérieurs entre les requêtes d’une conversation et renvoie des blocs de réflexion, conservez la conversation en ajout seul. Consultez Conserver les tours antérieurs inchangés.
  10. Gérez stop_reason: "refusal". Claude Haiku 5.5 exécute des classificateurs de sécurité qui peuvent refuser une requête, et il ne dispose d’aucun repli côté serveur. Consultez Refus de protection.
  11. Si vos prompts demandent au modèle d’écrire son raisonnement dans la réponse, par exemple dans des balises <thinking> ou <reasoning>, supprimez ces instructions. Claude Haiku 5.5 peut refuser une requête qui les contient et renvoyer la catégorie reasoning_extraction. Consultez Refus des mesures de protection.

Si votre organisation dispose d’un engagement Priority Tier sur Claude Haiku 4.5, planifiez la capacité séparément : Priority Tier n’est pas pris en charge sur Claude Haiku 5.5.

Claude Haiku 3.5 ou antérieur

  1. Remplacez l’identifiant de modèle Claude Haiku 3.5 ou Claude Haiku 3 par l’identifiant de Claude Haiku 5.5 pour votre plateforme. Consultez Migrer vers Claude Haiku 5.5 depuis Claude Haiku 3.5 et les modèles Haiku antérieurs.
  2. Si vous utilisez l’outil code_execution_20250522, passez à code_execution_20250825 ou à une version ultérieure.
  3. Si vous utilisez l’outil d’édition de texte, passez à text_editor_20250728.
  4. Gérez les raisons d’arrêt refusal et model_context_window_exceeded.
  5. Si votre code compare exactement les paramètres de type chaîne des appels d’outils, tenez compte des sauts de ligne finaux.
  6. Révisez vos prompts.

Utiliser l’identifiant de modèle Claude Haiku 5.5

Remplacez l’identifiant de modèle Claude Haiku 4.5 par l’identifiant de Claude Haiku 5.5 pour votre plateforme.

PlateformeClaude Haiku 4.5Claude Haiku 5.5
Claude APIclaude-haiku-4-5-20251001 ou claude-haiku-4-5claude-haiku-5-5
Amazon Bedrockanthropic.claude-haiku-4-5anthropic.claude-haiku-5-5
Claude Platform on AWSclaude-haiku-4-5claude-haiku-5-5
Claude Models on Google Cloud (Anthropic managed)claude-haiku-4-5-20251001claude-haiku-5-5
Claude Models on Google Cloud (Google managed)claude-haiku-4-5@20251001claude-haiku-5-5
Microsoft Foundryclaude-haiku-4-5claude-haiku-5-5

claude-haiku-5-5 est un identifiant de modèle fixe, sans suffixe de date ni alias distinct.

Recompter les tokens

Claude Haiku 5.5 utilise le même « tokenizer » (analyseur en tokens) que Claude 4.7 et les modèles ultérieurs. Comme pour tous les modèles qui utilisent ce tokenizer, le même texte d’entrée produit environ 30 % de tokens de plus sur Claude Haiku 5.5 que sur Claude Haiku 4.5. L’augmentation exacte dépend du contenu. Les requêtes, les réponses et les événements de streaming conservent la même structure. Ce qui change, c’est tout ce que vous mesurez ou budgétisez en tokens :

  • Les champs usage et les résultats du comptage de tokens sont plus élevés pour le même texte.
  • Un nombre donné de tokens contient moins de texte.
  • Une limite max_tokens ajustée pour Claude Haiku 4.5 peut tronquer une sortie équivalente.
  • Les estimations de coûts établies à partir du nombre de tokens de Claude Haiku 4.5 doivent être recalculées avec le nombre de tokens et les tarifs de Claude Haiku 5.5, y compris ses tarifs plus élevés pour les prompts longs. Consultez Tarification et Tarification du contexte long.

Les grandes images peuvent également coûter davantage de tokens. Claude Haiku 5.5 utilise le niveau d’image haute résolution, qui réduit les images dépassant 2 576 pixels sur le côté le plus long ou 4 784 tokens visuels. Claude Haiku 4.5 et les modèles Haiku antérieurs utilisent le niveau standard, qui réduit les images dépassant 1 568 pixels sur le côté le plus long ou 1 568 tokens visuels. Une image de 2 000 pixels sur 1 500 coûte environ 2,5 fois plus de tokens visuels sur Claude Haiku 5.5 que sur Claude Haiku 4.5. Consultez Résolution et coût en tokens.

Comptez vos prompts avec model défini sur claude-haiku-5-5 plutôt que de réutiliser les nombres mesurés sur Claude Haiku 4.5.

Configurer la réflexion

Claude Haiku 5.5 configure la réflexion différemment de Claude Haiku 4.5. Une valeur thinking de {"type": "enabled", "budget_tokens": N} renvoie une erreur 400 ; une requête qui l’envoie a donc besoin d’une nouvelle valeur thinking.

Avant, une requête à Claude Haiku 4.5 définissait thinking sur enabled avec un budget de tokens :

{
  "model": "claude-haiku-4-5",
  "max_tokens": 16000,
  "thinking": { "type": "enabled", "budget_tokens": 8000 },
  "messages": [{ "role": "user", "content": "..." }]
}

Après, la même requête à Claude Haiku 5.5 utilise l’« adaptive thinking » (réflexion adaptative). La valeur thinking change, et output_config.effort détermine le degré de réflexion du modèle :

{
  "model": "claude-haiku-5-5",
  "max_tokens": 16000,
  "thinking": { "type": "adaptive" },
  "output_config": { "effort": "medium" },
  "messages": [{ "role": "user", "content": "..." }]
}

La réflexion adaptative est activée par défaut ; une réponse peut donc commencer par un ou plusieurs blocs thinking même lorsque la requête ne définit pas thinking. Laissez thinking non défini ou définissez-le sur {"type": "adaptive"}, et utilisez l’« effort » (niveau d’effort) comme levier de contrôle : là où Claude Haiku 4.5 fonctionnait sans réflexion, ou avec un petit budget pour économiser des tokens, choisissez un niveau d’effort plus bas. À un niveau plus bas, le modèle réfléchit moins, et il peut ignorer entièrement la réflexion pour les requêtes plus simples. Pour des conseils de prompting, consultez Utiliser l’effort pour contrôler la réflexion. Sélectionnez les blocs de contenu par leur champ type plutôt que par leur position, et renvoyez les blocs thinking sans modification avec les résultats d’outils.

Les tokens de réflexion sont comptabilisés dans max_tokens ; une requête avec un petit max_tokens peut donc s’arrêter avec stop_reason: "max_tokens" après un bloc thinking et avant tout texte. Si vous aviez défini un petit max_tokens pour Claude Haiku 4.5, augmentez-le pour laisser de la place à la réflexion, ou choisissez un niveau d’effort plus bas.

Les blocs de réflexion des tours précédents de l’assistant restent dans le contexte et comptent comme des tokens d’entrée, alors que Claude Haiku 4.5 ne conserve que ceux du dernier tour. Les conversations à plusieurs tours comportent donc davantage de tokens d’entrée que ce que le seul changement de tokenizer explique. Pour supprimer les blocs plus anciens, utilisez l’effacement des blocs de réflexion. Consultez Conservation des blocs de réflexion selon le modèle.

Par défaut, Claude Haiku 5.5 renvoie chaque bloc thinking avec un champ thinking vide et uniquement une signature, alors que Claude Haiku 4.5 renvoie une réflexion résumée. Pour recevoir une réflexion résumée, définissez thinking: {"type": "adaptive", "display": "summarized"}.

Claude Haiku 5.5 accepte un tool_choice forcé (any ou un outil nommé), mais la réponse commence par l’appel d’outil et ne comporte aucun bloc thinking. Pour permettre au modèle de réfléchir avant d’appeler un outil, utilisez tool_choice: {"type": "auto"} et indiquez dans le prompt quand utiliser l’outil.

Une conversation que vous faites passer de Claude Haiku 4.5 à Claude Haiku 5.5 conserve son raisonnement. Pour les autres changements, cela dépend des deux modèles :

ChangementConserve son raisonnement
Vers Claude Haiku 5.5, depuis Claude Haiku 4.5 ou antérieur, Claude Sonnet 5 ou antérieur, ou Claude Opus 4.8 ou antérieurOui
Vers Claude Haiku 5.5, depuis tout autre modèleNon. L’API écarte les blocs de réflexion de ce modèle sans erreur.
Depuis Claude Haiku 5.5, vers Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.2 ou Claude Mythos 5.2Oui, uniquement sur la Claude API et Claude Models on Google Cloud (Google managed)
Depuis Claude Haiku 5.5, vers tout autre modèleNon

Consultez Changer de modèle puis revenir. Pour les changements qui n’impliquent pas Claude Haiku 5.5, consultez Quels changements de modèle conservent le raisonnement sur l’API Claude.

Supprimer les paramètres d’échantillonnage

Sur Claude Haiku 5.5, omettez temperature, top_p et top_k et utilisez plutôt le prompting pour guider le comportement du modèle.

Remplacer le préremplissage de l’assistant

Un « prefill » (préremplissage) est un dernier tour de l’assistant dans messages que le modèle poursuit. Claude Haiku 4.5 en accepte un lorsque la réflexion est désactivée. Claude Haiku 5.5 le rejette avec une erreur 400, même lorsque la réflexion est désactivée. Terminez messages par un tour de l’utilisateur, et remplacez chaque préremplissage en fonction de son objectif :

  • Format de sortie : utilisez les sorties structurées, ou des outils avec des champs enum pour la classification.
  • Préambules : demandez dans l’invite système une réponse directe.
  • Continuations : déplacez-les dans le message de l’utilisateur, par exemple « Votre réponse précédente a été interrompue et se terminait par [previous_response]. Reprenez là où vous vous êtes arrêté. »
  • Rappels de contexte : placez-les dans le tour de l’utilisateur.

Passer l’utilisation de l’ordinateur à l’ensemble d’outils

Claude Haiku 4.5 prend en charge l’utilisation de l’ordinateur via l’outil computer_20250124, avec l’en-tête bêta computer-use-2025-01-24. Claude Haiku 5.5 prend en charge l’utilisation de l’ordinateur via l’ensemble d’outils computer_toolset_20260801. Une requête adressée à Claude Haiku 5.5 qui déclare computer_20250124 renvoie une erreur 400.

Pour faire passer une intégration à l’ensemble d’outils, supprimez l’en-tête bêta computer-use-2025-01-24 et remplacez l’entrée tools par {"type": "computer_toolset_20260801"}. Effectuez ensuite les autres modifications de requête et de boucle d’agent décrites dans Migrer depuis computer_20251124. Effectuez la répartition en fonction des champs name et toolset_name de chaque bloc tool_use membre plutôt qu’en fonction de input.action. Traitez chacun de ces blocs dans un tour et renvoyez toolset_name dans les résultats. Le zoom est activé par défaut dans l’ensemble d’outils ; si votre environnement ne l’implémente pas, ajoutez "configs": {"zoom": {"enabled": false}}. Si vous envoyez l’en-tête bêta fine-grained-tool-streaming-2025-05-14, supprimez-le. Utilisé conjointement avec une entrée d’ensemble d’outils, il renvoie une erreur 400.

Sur Amazon Bedrock, Claude Haiku 5.5 accepte également l’outil computer_20251124 avec l’en-tête bêta computer-use-2025-11-24.

Claude Haiku 5.5 prend en charge l’outil d’utilisation du navigateur (browser_toolset_20260801) pour les tâches au sein des pages web. Claude Haiku 4.5 ne le prend pas en charge.

Rejouer les blocs de réflexion via le compte qui les a produits

Les blocs de réflexion de Claude Haiku 5.5 ne fonctionnent que dans le compte qui les a produits ou dans un compte qui lui est lié. Lorsqu’un autre compte envoie l’un de ces blocs, l’API écarte le bloc avant que le modèle ne le reçoive, et la requête réussit sans ce raisonnement. Cela affecte le code qui stocke des conversations et les rejoue via un compte différent, par exemple un service qui sert plusieurs clients à partir d’un même stockage de conversations. Rejouez chaque conversation via le compte qui l’a produite. Consultez Comptes et plateformes cloud.

Conserver les tours antérieurs inchangés

Conservez les conversations en ajout seul. Un bloc de réflexion de Claude Haiku 5.5 ne reste valide que tant que tout ce qui a été envoyé avant lui reste inchangé : le prompt system, les tools et chaque message précédent.

Échouer à la « prefix check » (vérification du préfixe) peut entraîner ou non une erreur 400. Pour identifier et gérer ces deux cas, consultez Vérifications du préfixe sur les blocs de réflexion.

Pour connaître les modifications qui déclenchent l’erreur et ce qu’il faut faire à la place, consultez Si votre code modifie l’invite système, les outils ou l’historique.

Migrer vers Claude Haiku 5.5 depuis Claude Haiku 3.5 et les modèles Haiku antérieurs

Claude Haiku 3.5 est retiré sur la Claude API, Amazon Bedrock et Claude Models on Google Cloud (Google managed). Claude Haiku 3 est retiré sur la Claude API et Claude Models on Google Cloud (Google managed). Consultez Dépréciations de modèles.

Depuis l’un ou l’autre de ces modèles, appliquez d’abord toutes les sections précédentes, puis ces modifications :

  • Identifiant de modèle : remplacez claude-3-5-haiku-20241022, son alias claude-3-5-haiku-latest ou claude-3-haiku-20240307 par claude-haiku-5-5. Sur Claude Models on Google Cloud (Google managed), remplacez claude-3-5-haiku@20241022 par claude-haiku-5-5. Sur Amazon Bedrock, utilisez l’identifiant de Claude Haiku 5.5 indiqué dans Utiliser l’identifiant de modèle Claude Haiku 5.5.
  • Exécution de code : Claude Haiku 5.5 accepte code_execution_20250825 et les versions ultérieures. Si vous utilisez code_execution_20250522, limité à Python, passez à l’une d’elles. Consultez Passer à la dernière version de l’outil.
  • Éditeur de texte : si vous utilisez l’outil d’édition de texte, passez à text_editor_20250728 (nom d’outil str_replace_based_edit_tool), qui ne dispose pas de la commande undo_edit. Consultez Outil d’édition de texte.
  • Raisons d’arrêt : gérez refusal et model_context_window_exceeded. Consultez Raisons d’arrêt et repli.
  • Sauts de ligne finaux : Claude 4.5 et les modèles ultérieurs conservent les sauts de ligne finaux dans les paramètres de type chaîne des appels d’outils. Si votre code compare exactement ces chaînes, tenez-en compte.
  • Prompts : Claude 4 et les modèles ultérieurs ont un style de communication plus concis et plus direct, et nécessitent des instructions explicites. Révisez vos prompts en vous appuyant sur Rédiger des prompts pour Claude Haiku 5.5 et Bonnes pratiques de prompting.

Cette page vous a-t-elle été utile ?