OpenAIのプロンプトキャッシュ12時間とは|料金と使い方
OpenAIがAPIに追加した12時間のプロンプトキャッシュを速報で解説。30分(書き込み1.25倍)と12時間(2.5倍)の料金の違い、prompt_cache_optionsの指定方法、何回使えば得になるかの計算、Codexの「キャッシュ無期限」発言の確認状況をまとめます。

OpenAIは2026年10月20日(米国)、APIのプロンプトキャッシュで12時間の保持期間を選べるようにしました。対象はResponses APIのGPT-5.6以降のモデルです。キャッシュへの書き込み料金は、既定の30分が通常入力の1.25倍、12時間が2.5倍で、読み出しの料金はどちらも同じです。公式の倍率から計算すると、30分以上あけて同じ内容を使うなら、3回目のリクエストから12時間のほうが安くなります。
プロンプトキャッシュとは、前のリクエストと先頭が同じ入力(共通の指示・ツール定義・会話履歴など)の計算結果を保存して再利用し、その部分を安い単価で処理する仕組みです。本記事は2026年10月21日(日本時間)時点の速報版です。公式ドキュメントで確認できた範囲だけをまとめ、実地検証や公式の続報が入りしだい更新します。
何が変わったか(30分と12時間)
公式のプロンプトキャッシュのガイドによると、GPT-5.6以降では prompt_cache_options.ttl で最低限の保持期間を選びます。倍率は通常(キャッシュなし)の入力単価に対する比率で、上乗せ分ではなく書き込みの料金そのものです。
| 指定 | 最低限の保持期間 | 書き込みの料金 | 読み出しの料金 | 向いている使い方(公式) |
|---|---|---|---|---|
| "30m"(既定) | 30分 | 通常入力の1.25倍 | 0.1倍(GPT-6.1 Solは0.05倍) | 文脈を頻繁に再利用する会話やエージェント |
| "12h" | 12時間 | 通常入力の2.5倍 | 30分と同じ | 長い間隔をあけて使う、変わらない指示や資料 |
「12時間」は最低限残る時間で、削除の期限ではありません。OpenAIがそれより長く残すこともあり、データ保持の上限の方針も変わらないと明記されています。12時間の指定はResponses APIのみで、それ以前のモデルは従来どおり prompt_cache_retention(in_memory/24h)で指定します。
使い方(指定の例)
リクエスト全体に12時間を指定するなら、"prompt_cache_options": { "ttl": "12h" } を加えます。公式ガイドには、1日中使う共通の指示だけを12時間、会話の文脈を30分にする例も載っています(下は公式の例を短くしたもの)。
{
"model": "gpt-6.1-sol",
"prompt_cache_options": { "mode": "explicit", "ttl": "30m" },
"input": [
{ "role": "developer", "content": [
{ "type": "input_text", "text": "1日中使う共通の指示や資料...",
"prompt_cache_breakpoint": { "mode": "explicit", "ttl": "12h" } } ] },
{ "role": "user", "content": [
{ "type": "input_text", "text": "しばらく使う会話の文脈...",
"prompt_cache_breakpoint": { "mode": "explicit" } },
{ "type": "input_text", "text": "今回の質問(キャッシュに書き込まない)..." } ] }
]
}
注意点は3つです。キャッシュされるのは1,024トークン以上の先頭部分で、1リクエストで書き込めるのは最大4か所です。対応していない値を指定すると400エラーになります。
いつ得になるか(計算)
ここからは公式の倍率だけを使った計算で、実測ではありません。同じ先頭部分を、毎回30分以上(12時間以内)あけてN回使うとします。30分の指定では毎回期限が切れるので、毎回1.25倍で書き直しになります。12時間なら、1回目に2.5倍で書き込み、2回目以降は0.1倍の読み出しで済みます。
- 30分(毎回書き直し):1.25 × N
- 12時間:2.5 + 0.1 ×(N − 1)
- キャッシュしない:1.0 × N
N=2では30分が2.5、12時間が2.6で、まだ30分のほうがわずかに安い計算です。N=3では30分が3.75、12時間が2.7となり、ここから逆転します(読み出しが0.05倍のGPT-6.1 Solでも同じく3回目から)。一方、30分以内に次のリクエストが来る使い方なら、読み出すたびに期限が延びるため、30分のほうが常に通常入力1.25回分だけ安くなります。
金額にすると、たとえばGPT-6.1 Sol(料金ページの標準の表示価格、1Mトークンあたり入力$2.00・キャッシュ入力$0.10・30分書き込み$2.50・12時間書き込み$5.00)で、10万トークンの共通資料を1〜2時間おきに1日5回使う場合はこうなります。
| 方法 | 計算 | 合計(試算) |
|---|---|---|
| キャッシュしない | 5回 × 0.1M × $2.00 | $1.00 |
| 30分(毎回書き直し) | 5回 × 0.1M × $2.50 | $1.25 |
| 12時間 | 0.1M × $5.00 + 4回 × 0.1M × $0.10 | $0.54 |
質問文や出力の料金は含めていません。また、公式ガイドは、保持期間は「キャッシュ料金の対象になる期間」を決めるもので、毎回キャッシュが使われることや応答が速くなることを保証するものではないとしています。
Codex・ChatGPT Workの「無期限キャッシュ」
APIとは別に、OpenAIのTibo Sottiaux氏は2026年10月21日(日本時間)、Xで「ログインしているユーザーには、CodexとWork全体でキャッシュを無期限(forever)に保つ。古い会話に戻っても、数時間後に再開してもペナルティはなく、キャッシュに必ずヒットする」という趣旨を投稿しました。ただし、本記事の時点でこれを明記した公式ドキュメントやCodexの変更履歴は見つかっていません。OpenAI開発者フォーラムのまとめスレッドでは、モデレーターが「12時間キャッシュがCodexとChatGPT Workで既定で有効になった」と書いており、「無期限」とは表現が異なります。
公式の料金ページで確認できたのは、Codexのクレジット課金にはキャッシュ書き込みの別料金がないという点です。編集部がCodex CLI 0.163.0(ChatGPTでログイン、GPT-6.1 Sol)で小さな質問を2回実行し、1回目の会話を約30秒後にresumeしたところ、入力のうちキャッシュ分は90.4%・98.3%・92.1%で、書き込みトークン(cache_write_input_tokens)はいずれも0でした。ただし再開までが短く、「数時間後でもヒットする」かはまだ確かめていません。Codexの使い方と実測はCodex CLIの使い方、Claude Codeで入力の約98%がキャッシュ読み出しだった実測はClaude Codeの料金と実測コストにまとめています。
未確認の点
速報時点で、次の各点は確認できていません。確認できしだい更新します。
- Codex・Workの「無期限」:出典はTibo Sottiaux氏のXの投稿のみで、公式ドキュメントや変更履歴での裏付けは確認できていません。フォーラムのまとめは「12時間」と書いており、どちらが正確かは未確認です。
- 使用量の枠への影響:キャッシュが長く残ることで、プランの使用量の消費がどれだけ減るのかは公表されていません。
- 対象のプラン:「ログインしているユーザー」がFree・Go・Plus・Pro・Business・Edu・Enterpriseのどこまでを指すのかは明記されていません。
- 数時間あけたときの実測:Codexで会話を数時間あけて再開したときのキャッシュの数値は、まだ測っていません。
- APIでの実際の請求:編集部はAPIキーで12時間キャッシュを試しておらず、usageの値と請求額の実測はありません。
よくある質問
Q. OpenAIのプロンプトキャッシュ12時間とは何ですか?
2026年10月20日にOpenAIがAPIへ追加した、プロンプトキャッシュの保持期間の選択肢です。Responses APIのGPT-5.6以降で、prompt_cache_options.ttl に 12h を指定すると、キャッシュが最低12時間残ります。既定は30分です。
Q. 12時間キャッシュの料金はいくらですか?
書き込みが通常の入力単価の2.5倍です。既定の30分は1.25倍で、どちらも上乗せではなく書き込みの料金そのものです。読み出しは30分と同じで、多くのモデルで0.1倍、GPT-6.1 Solは0.05倍です。
Q. 30分と12時間はどちらを選べばよいですか?
次のリクエストが30分以内に来るなら30分のほうが安くなります。30分以上あけて同じ内容を使う場合、公式の倍率で計算すると3回目のリクエストから12時間のほうが安くなります。1日に何度も使う共通の指示や資料だけを12時間にする指定もできます。
Q. Codexではキャッシュが無期限になったのですか?
OpenAIのTibo Sottiaux氏がXで、ログインしているユーザーにはCodexとWorkでキャッシュを無期限に保つと投稿しました。ただし本記事の時点で公式ドキュメントでは確認できておらず、使用量への影響や対象プランも未確認です。
参考にした情報
本記事はOpenAIの公式ドキュメントと、編集部が取得・確認できた情報に基づきます。料金や仕様は変わることがあるため、最新情報は公式で確認してください。取得日時はいずれも2026年10月21日17時台(日本時間)です。
- OpenAI API Changelog(公式)(新しいウィンドウで開く):10月20日の項目(12時間のプロンプトキャッシュ、12時間の書き込みは入力単価の2.5倍)。
- Prompt caching(OpenAI公式ガイド)(新しいウィンドウで開く):ttl の指定、30分と12時間の倍率、読み出しの倍率、ブレークポイントごとの指定、旧モデルの prompt_cache_retention。
- API Pricing(OpenAI公式)(新しいウィンドウで開く):GPT-6.1 Solなどの入力・キャッシュ入力・30分/12時間書き込みの単価。
- Pricing(ChatGPT・Codex公式ドキュメント)(新しいウィンドウで開く):Codexのクレジット課金にキャッシュ書き込みの別料金がないこと。
- OpenAI Developersの投稿(X)(新しいウィンドウで開く):12時間キャッシュの告知。
- Tibo Sottiaux氏の投稿(X)(新しいウィンドウで開く):Codex・Workのキャッシュに関する発言。
- OpenAI開発者フォーラムのまとめスレッド(新しいウィンドウで開く):「Day 16」の一覧とモデレーターの投稿。


