仕様の整理・2026年11月8日に確認
プロンプトキャッシュが効く最小トークン数の差
短すぎる入力はキャッシュされません。しかもエラーは出ません。モデルを新しくすると最小が下がり、前は効かなかった短い指示文がキャッシュされるようになります。逆も起きます。
このサイトはAnthropicの公式サイトではありません。モデルの提供状況・仕様・料金は変わる可能性があるため、実装や契約の前には公式のドキュメントとご自身のアカウント設定を確認してください。
先に結論
公式のキャッシュのページでは、最小のトークン数は 512(Fable 5.1・Mythos 5.1・Opus 5.5・Opus 5・Sonnet 5.5・Fable 5・Mythos 5・Haiku 5.5)、1,024(Opus 4.8・Sonnet 5・Sonnet 4.6 ほか)、2,048(Opus 4.7・Mythos Preview)、4,096(Opus 4.6・Opus 4.5・Haiku 4.5)です。
最小に満たないと、キャッシュなしで処理されます。効いたかどうかは、応答の cache_creation_input_tokens と cache_read_input_tokens が両方0かどうかで分かります。
最小トークン数の表
| 最小 | 該当するモデル(公式の記載) |
|---|---|
| 512 | Fable 5.1・Mythos 5.1・Opus 5.5・Opus 5・Sonnet 5.5・Fable 5・Mythos 5・Haiku 5.5 |
| 1,024 | Opus 4.8・Sonnet 5・Sonnet 4.6・Sonnet 4.5・Opus 4.1・Opus 4・Sonnet 4 |
| 2,048 | Mythos Preview・Opus 4.7 |
| 4,096 | Opus 4.6・Opus 4.5・Haiku 4.5 |
この表は Claude API・Claude Platform on AWS・Google Cloud(Google 運営)・Microsoft Foundry に当てはまります。Bedrock は AWS の資料に独自の最小があります。
切り替えで起きること
- Haiku 4.5 から 5.5 へ:最小が4,096から512に下がる。以前は短くてキャッシュされなかった指示文が、キャッシュの対象になる
- Sonnet 5 から 5.5 へ:1,024から512へ。公式の移行ガイドも「512トークン以上でキャッシュのエントリができる」と注意している
- Opus 4.8 以前から 5.5 へ:同じく、512以上でキャッシュが作られる
キャッシュが作られると、書き込みの割増(5分で1.25倍、1時間で2倍)が最初の1回に乗ります。読まれないまま終わる呼び出しでは、書き込みの分だけ高くなります。
確かめる手順
- 代表的な依頼を2回続けて送る(5分以内)
- 2回目の
usageでcache_read_input_tokensが0でないかを見る - 0なら、先頭から共通部分までのトークン数を数え、最小以上か確かめる(数え方はトークナイザーの面)
- 共通部分が完全一致かを見る。先頭が1文字でも違うと別物
具体例:短い指示文がキャッシュされない原因を探す
Haiku 4.5 で3,000トークンのシステムプロンプトを使っていたとします。最小は4,096なので、キャッシュは効かず、cache_read_input_tokens は常に0でした。Haiku 5.5 に替えると最小が512に下がるため、同じ3,000トークンで初めてキャッシュが効きます。これは割安になる方向の変化です。逆に、Sonnet 5.5 から Opus 4.7(最小2,048)に戻すような替え方をすると、1,500トークンの前置きは効かなくなります。モデルを行き来するルーターでは、最小を表で持っておくと原因の特定が早くなります。
この面で確かめていないこと
- Bedrock の最小(AWS の資料を読んでいない)
- 日本語の指示文が何トークンになるかの実測
よくある質問
最小に満たないとエラーになりますか?
なりません。キャッシュなしで処理されるだけです。usage の2つの項目が0になります。
現行4モデルの最小は?
すべて512トークンです。
5分で切れますか?
既定の寿命は5分で、使われるたびに延びます。1時間の指定もできます。
出典(2026年11月8日に確認)
- プロンプトキャッシュ(Anthropic の API ドキュメント) https://platform.claude.com/docs/en/build-with-claude/prompt-caching
- Opus 5.5 の移行ガイド(Anthropic の API ドキュメント) https://platform.claude.com/docs/en/models/opus-5-5/migration-guide
- 料金(Anthropic の API ドキュメント) https://platform.claude.com/docs/en/about-claude/pricing
編集:ちんあなご編集部。記事の文は写さず、日付・数字・名前などの事実だけを自分の文で書いています。