Haiku 5.5移行の400エラーと長文課金の落とし穴

Haiku 5.5は2026年10月7日公開の小型モデルで、分類・抽出・ルーティング向けです。モデルIDはclaude-haiku-5-5です。

分類や抽出を安いHaiku 4.5で回している中小企業は、モデルIDを書き換えるだけでは動かなくなります。Haiku 5.5では、従来通りの設定が400エラーを返します。さらに料金はプロンプトの長さで単価が変わります。移行前に押さえる点を整理します。

Claude Haiku 5.5とは何か

Haiku 5.5は2026年10月7日公開の小型モデルで、分類・抽出・ルーティング向けです。モデルIDはclaude-haiku-5-5です。

公式のモデル一覧では、コンテキストは1Mトークン、最大出力は128Kトークン、思考はadaptive（effortの既定値はmedium）です。リタイアは2027年10月7日より前にはならないとされています。

中位のSonnet 5.5は入力$2・出力$10、Opus 5.5は入力$4・出力$20です。大量処理を安く回す層として位置づけられており、選定の考え方は中小企業のClaudeモデル選定も参照してください。

手動の思考設定、temperature系、prefillの3つは、Haiku 5.5で400エラーになります。移行の前に洗い出してください。

移行ガイドが挙げる主な変更は次のとおりです。

thinking: {"type": "enabled", "budget_tokens": N}は400になる。{"type": "adaptive"}に変え、思考量はoutput_config.effortで調整する
temperature・top_p・top_kは削除する。指定するならtemperatureは1、top_pは0.99のみ許される
最後のメッセージをassistantにするprefillは400になる。出力形式の固定には構造化出力を使う
応答がthinkingブロックから始まりうる。先頭ブロックを回答とみなさず、typeで選ぶ
Computer Useのcomputer_20250124は400になる。Claude APIではcomputer_toolset_20260801へ移す

Priority TierもHaiku 5.5では未対応です。Haiku 4.5で枠を契約している場合は、容量を別途検討してください。Claude Code向けの/claude-api migrateでも、IDの置換と破壊的変更の洗い出しができます。

Haiku 5.5はプロンプトが100,000トークンを超えると、入力$0.50・出力$2.50に上がります。以下なら入力$0.10・出力$0.50です。

公式の料金表では、100Kトークン以下が入力$0.10・出力$0.50、超えると入力$0.50・出力$2.50です。単価は入力で5倍です。判定はリクエスト単位で、キャッシュ読み取りも入力トークンに数えます。一部がキャッシュヒットでも、超えたリクエストは高い単価になります。

Sonnet 5.5を含む4.6以降の他モデルは、1Mトークン全体が標準単価です。長文を毎回投げる用途では、Haiku 5.5が割高になる場合があります。

試算で見落としやすい点もあります。

claude-haiku-5-5でトークン事前カウントを取り直し、max_tokensも見直してください。

移行は、設定の修正、トークン再計測、品質比較の順に進めます。最後に本番へ切り替えます。

大量の定型処理はバッチAPIで50%引きにできます。Haiku 5.5のバッチ単価は、100Kトークン以下で入力$0.05・出力$0.25です。旧モデルの扱いは非推奨化への備えにまとめています。移行の段取りはKuuの運用管理サービスでも支援しています。

Haiku 5.5の移行は、400エラーの解消と、100Kトークン境界の課金確認の2点が要です。

IDの置換だけで済ませず、設定の修正とトークン再計測を先に行ってください。移行計画の相談は、Kuuにお寄せください。