thinking.display の3つの値と、思考の文が空になる理由

先に結論

Fable 5（2026年6月9日）以降の世代では、thinking.display の既定は "omitted" です。思考のブロックは来ますが、thinking の欄は空で、signature だけが入っています。読める要約が要るなら "summarized" を指定します。思考が省かれても、思考のトークンは出力として課金されます。

3つの値

Haiku 5.5 も、Haiku 4.5 と違い、display: "summarized" を付けない限り思考の文は出ません（2026年10月7日のリリースノート）。

アプリで直す手順

1. ストリームを受ける側で、最初のブロックを本文と決め打ちしていないか確かめる。思考ブロックが先に来る
2. 「考え中」を出したいときは、thinking: {"type": "adaptive", "display": "summarized"} にする
3. ツールの往復では、思考ブロックを加工せず署名ごと返す。空のブロックも含めて、そのまま戻す
4. ツールの間に出す短い前置きの文が消えたら、それも思考ブロックの中に移っている（Opus 5.5 の移行ガイド）。display を updates か summarized にして描く

課金との関係

思考の文を返さない設定でも、使った思考のトークンは出力として課金され、max_tokens の枠も使います。「表示が空＝考えていない＝無料」ではありません。実際の量は、usage.output_tokens_details.thinking_tokens で見られます。

具体例：チャット画面で「考え中」が消えたとき

チャットのUIが、思考の要約を灰色の文字で流していたとします。新しいモデルに替えると、その欄が空になり、最初の文字が出るまで数秒の無言が続きます。まず、API の応答に思考ブロックが来ているかを開発者ツールで確かめます。type が thinking で、thinking の欄が空文字なら、これは omitted の効果です。display を summarized にすれば要約が戻ります。UI側は、空の思考ブロックを「考え中」の点滅表示に割り当てる手もあります。中身を出さずに進み具合だけを示せます。

よくある取り違え

• 「思考が空なら課金もない」と読む：思考のトークンは出力として課金され、max_tokens の枠も使う
• 「空のブロックは捨ててよい」と読む：ツールの往復では、署名つきでそのまま返さないと400
• 「全モデルが同じ既定」と読む：Haiku 4.5 までは別。5.5 から omitted が既定

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

• updates の返し方の細部（ベータの記述をリリースノートで読んだのみ）
• 要約の長さ・品質（測っていない）

よくある質問

次に読むページ