Claude Haiku 5.5 is not a model id swap. Five things that worked on Haiku 4.5 now return a 400.
The model id is the easy part. The requests that now fail, the response parsing that changes, and the details that fail quietly.
- Model id
- claude-haiku-5-5, fixed, no date suffix and no alias
- Launched
- 7 October 2026
- Context and output
- 1M tokens in, 128K max out
- Thinking
- Adaptive by default. Text omitted unless thinking.display is "summarized"
- Tokenizer
- About 30 percent more tokens than Haiku 4.5 for the same text
- Not supported
- Priority Tier. Structured outputs on Amazon Bedrock
The five requests that now fail
The migration guide is explicit that each of these returns a 400 error on Haiku 5.5. If you work from the Haiku 4.5 checklist, these are the lines to search for.
- Manual thinking. A thinking value of {"type": "enabled", "budget_tokens": N} fails. Use {"type": "adaptive"} and set output_config.effort instead.
- Sampling parameters. Omit temperature, top_p and top_k. If temperature is present it must be 1, if top_p is present it must be 0.99, any top_k fails, and sending both temperature and top_p fails. A top_p of 1 also fails.
- Assistant prefill. A final assistant turn in messages fails even with thinking turned off. End with a user turn.
- The old computer use tool. computer_20250124 fails. On the Claude API and Google Cloud use the computer_toolset_20260801 toolset, and on Amazon Bedrock use computer_20251124 with the computer-use-2025-11-24 beta header. Sending the fine-grained-tool-streaming-2025-05-14 beta header alongside a toolset entry also fails.
- Resent thinking blocks after a change. Sending a thinking block back after changing system, tools or earlier messages fails. Keep conversations append only. On accounts created before 31 August 2026 00:00 UTC, the error comes only on requests that set thinking.block_binding.prefix_mismatch_behavior.
Thinking changes your response parsing
Adaptive thinking is on by default, so a response can begin with one or more thinking blocks even when the request never sets thinking. Code that reads the first content block as the answer will break, so select blocks by their type. The guide also says by default each thinking block comes back with an empty thinking field and only a signature, where Haiku 4.5 returned summarized thinking. Set thinking.display to "summarized" if you want the text.
Thinking tokens count toward max_tokens, so a request with a small limit can stop with stop_reason "max_tokens" after a thinking block and before any text. Raise the limit or choose a lower effort level. Thinking blocks from earlier assistant turns also stay in context and count as input tokens, where Haiku 4.5 kept only the latest turn.
A forced tool_choice of any or a named tool is accepted, but the response starts with the tool call and has no thinking block. To let the model think before a tool call, use tool_choice auto and say in the prompt when to use the tool.
Prefill has no drop in replacement
Which replacement you use depends on what the prefill was for, according to the guide.
- Output format: use structured outputs, or tools with enum fields for classification. On Amazon Bedrock structured outputs are not available for this model, so describe the format in the prompt, use a tool without strict, and validate the output in your code.
- Preambles: ask in the system prompt for a direct answer.
- Continuations: move them into the user message, for example by saying the previous response was interrupted and quoting where it ended.
- Context reminders: put them in the user turn.
What fails quietly, or only on some platforms
The tokenizer is the one that reaches your bill and your limits: about 30 percent more tokens for the same text, and a 2,000 by 1,500 pixel image costs about 2.5 times as many visual tokens because Haiku 5.5 uses the high resolution image tier. A max_tokens tuned for Haiku 4.5 can truncate equivalent output. See our pricing story for how that interacts with the 100,000 token price line.
Thinking blocks from Haiku 5.5 work only in the account that produced them or an account linked to it. When another account sends one, the API drops the block and the request succeeds without that reasoning, so a service that replays stored conversations through a different account loses context without an error.
Haiku 5.5 runs safety classifiers that can decline a request, and it has no server side fallback, so handle stop_reason "refusal". If your organisation has a Priority Tier commitment on Haiku 4.5, plan that capacity separately because Priority Tier is not supported on Haiku 5.5.
Managed Agents users are the exception: the guide says no changes beyond updating the model name are required.
What to do
- 1Replace the model id with claude-haiku-5-5 for your platform. Amazon Bedrock uses anthropic.claude-haiku-5-5.
- 2Search for budget_tokens, temperature, top_p, top_k and any request that ends with an assistant message, and remove or rewrite each.
- 3Select response content blocks by type, and raise max_tokens to leave room for thinking.
- 4Recount your prompts with model set to claude-haiku-5-5, then recompute cost and limits.
- 5Handle the refusal stop reason, and keep conversations append only if you send thinking blocks back.
- 6Move computer use to computer_toolset_20260801, or computer_20251124 on Bedrock.
Common questions
What is the Claude Haiku 5.5 model id?
claude-haiku-5-5 on the Claude API, Claude Platform on AWS, Google Cloud and Microsoft Foundry, and anthropic.claude-haiku-5-5 on Amazon Bedrock. It is a fixed id with no date suffix and no alias.
Can I still set temperature on Haiku 5.5?
Only to its default. If temperature is present it must be 1, and a request that sets both temperature and top_p returns a 400 error. Anthropic recommends omitting these and using prompting instead.
Does prefill work with thinking off?
No. Haiku 5.5 rejects an assistant prefill with a 400 error even when thinking is turned off.
Do I need to change anything for Managed Agents?
The migration guide says if you use Claude Managed Agents, no changes beyond updating the model name are required.
Sources
- Anthropic: Claude Haiku 5.5 migration guide
- Anthropic: API release notes
- Anthropic: model deprecations
Read against the primary documentation rather than secondary coverage. Where a figure comes from a provider's own docs, it is quoted as published on 2026-10-15.
Related
More from Signals
Open the tool.
Ten production categories, three minutes, and a ranked list of what to fix first.
Check your own stack