Claude Haiku 5.5 の破壊的変更：Haiku 4.5 から移行するときの 5 つの 400 と公式の直し方

temperature・top_p・top_k をリクエストから削除してください。移行ガイドによると、temperature を含めるなら 1、top_p を含めるなら既定値の 0.99 でなければならず、それ以外の値はすべて 400 エラーです（top_p が 1 でも同じ）。top_k はどの値でも、temperature と top_p を両方送った場合も 400 になります。公式の Thinking ドキュメントは、これが思考の有無に関係なくすべてのリクエストに適用されると補足しています。この項目のエラー原文は公開されておらず、本ページでも作りません。

使えません。thinking を enabled と budget_tokens で送ると 400 エラーになるので、{"type": "adaptive"} に替えて output_config.effort で深さを調整します。思考をオフにするなら、Haiku 5.5 は effort が high 以下のとき {"type": "disabled"} を受け付けます。xhigh か max でそう送ると 400 になり、エラー原文は output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking. です。公式は、思考をオフにするより effort で品質と速度・コストを調整するほうがよいとしています。

バグではありません。Haiku 5.5 は adaptive thinking が既定でオンなので、リクエストで thinking に触れていなくても、レスポンスが 1 つ以上の thinking ブロックで始まることがあります。ブロックは位置ではなく type フィールドで選んでください。既定では各 thinking ブロックの thinking フィールドは空で、signature だけが入っています。要約を受け取るには {"type": "adaptive", "display": "summarized"} を設定します。思考のトークンは max_tokens に数えられるので、上限が小さいと thinking ブロックの後、本文の前で止まることがあります。

送り返した thinking ブロックより前の system プロンプト、tools、または以前の messages が変わったという意味です。Haiku 4.5 はこのチェックを行いません。2026-08-31 00:00 UTC より前に作成したアカウントでは thinking.block_binding.prefix_mismatch_behavior を設定したリクエストでのみ出て、それ以降のアカウントでは既定で出ます。同じ本文を再送しても解消しません。直し方：会話は追記のみにし、指示は system や tools を書き換えずに会話途中の system メッセージで足します。いまのリクエストを通したいなら、thinking-binding-controls-2026-08-01 の beta ヘッダーを付けて prefix_mismatch_behavior を drop_block にします。

thinking を含むリクエスト本文では無理です。公式のモデル別の表では、Haiku 4.5 は extended thinking のみ対応で adaptive を拒否し、Haiku 5.5 は adaptive のみ対応で enabled を拒否します。既定値も違い、Haiku 4.5 は思考オフ、Haiku 5.5 は思考オンが既定です。thinking フィールドはモデルごとに分岐させてください。

停止日は公開されていません。2026-10-08 時点で非推奨表の claude-haiku-4-5-20251001 は Active、Deprecated 欄は N/A、Tentative retirement date 欄は Not sooner than October 15, 2026 で、これは下限であって停止日ではありません。claude-haiku-5-5 の行は Not sooner than October 7, 2027 です。いつ移るかは、ご自身のワークロードでのテストで判断してください。