Opus 5.5 に切り替えるとき400になる指定

先に結論

Opus 5.5 に送る依頼は、次の条件を満たす必要があります。満たさないと400が返ります。

• 思考：thinking を送らない（または {"type": "adaptive"}）。disabled と手動の budget_tokens は400
• effort：思考の深さを変える唯一の指定。既定は medium
• tool_choice：auto か none。any と tool は400
• サンプリング：temperature・top_p・top_k は送らない
• プリフィル：assistant の先書きで終わる messages は400
• 計算機操作：computer_toolset_20260801 を宣言する（Bedrock は computer_20251124 も可）
• 文脈：1Mが既定。文脈用のヘッダーは要らない

外す順番

1. thinking の disabled と enabled（予算つき）を削除し、effort を明示する
2. tool_choice の強制を auto に直す。強制していた目的は、公式が案内する strict なツール利用か構造化出力で満たす
3. temperature・top_p・top_k を削除する（経緯）
4. 末尾の assistant の先書きを削除する（代わりの手段）
5. 応答の読み方を直す。応答は thinking ブロックから始まることがあり、content[0].text のように位置で読むと壊れる。type が text のブロックを探す

外したあとに確かめる3点

• max_tokens：思考と本文の合計の上限。思考なしで動いていた処理は、出力トークンが増えうる。xhigh と max では64kから始めるのが公式の出発点
• 思考の文：既定で空（omitted）。読める要約が要るなら display: "summarized"（表示の指定）
• ツール利用の往復：思考ブロックを加工せずに返す。並べ替え・欠落・編集は400

前の世代との料金・既定の差はOpus 5 から 5.5 への面に置きました。

具体例：400を1つずつ潰す順番の記録

実際に移すときは、本番に送る前に、同じ入力を4回に分けて試すと原因が切り分けられます。1回目はモデル名だけ替えて送り、返った400の理由を読む。2回目は thinking を外して送る。3回目は tool_choice を auto に直す。4回目は temperature などを外す。1つ直すたびに次のエラーが出る形になり、残りの数が見えます。公式の移行ガイドが「どの出発点でも守る項目」を先頭に置いているのは、この順に潰せば止まらずに進めるからです。最後に応答の読み方を確かめます。

よくある取り違え

• 「400は1種類だけ」と読む：思考・tool_choice・サンプリング・プリフィル・計算機操作のどれでも別々に400になる
• 「thinking を外せば思考がなくなる」と読む：Opus 5.5 は思考が常時オンで、外すと既定の適応型で動く
• 「Managed Agents も同じ作業が要る」と読む：公式は、Managed Agents はモデル名の更新以外は要らないと書いている

この面で確かめていないこと

• 各指定が実際に返すエラーメッセージの文面（こちらでは送っていない）
• Bedrock など他社運営の面での差（Bedrock で computer_20251124 が使えることのみ公式に記載）

よくある質問

次に読むページ