OpenAI Prompt Caching 2026 官方计费指南：输入缓存 $/M 与命中率门槛
内容刷新 / GEO：补 English summary 与最新核对清单 — oa-cache-when-2026
ガイド一覧 · 本文は主に簡体字中国語です。国際向けの要点は English summary をご利用ください。
OpenAI Prompt Caching 2026 官方计费指南：输入缓存 $/M 与命中率门槛
OpenAI 的 Prompt Caching 功能让 API 请求能重用先前处理过的提示前缀，输入缓存价格显著低于标准输入单价。适合需要长期多轮对话或持续运行的代理应用的用户。通过优化提示结构、保持稳定前缀和监控命中率，您可以大幅降低每百万 tokens 的实际成本，并提升响应速度。本指南基于 OpenAI 官方定价页最新数据，帮助您对账单、决定是否启用缓存以及计算有效单价。
现状与数据更新
OpenAI 于 2026 年对 GPT-6 系列模型的提示缓存系统进行了重大升级。默认命中率显著提升，支持 30 分钟和 12 小时两种缓存窗口，同时新增监控仪表盘和诊断工具。缓存不再依赖旧版 24 小时限制，而是与 Responses API 深度集成，适用于持续代理场景。
官方定价表明确区分了三种输入类型：
- 标准输入（全新提示）：按全价计费。
- 缓存输入（匹配前缀）：大幅折扣。
- 命中率门槛：提示长度需达到 1024 tokens 以上（以 128 tokens 为增量），前缀稳定时命中率可达 80-90%。
以 GPT-6.1-Sol 为例，标准输入价为 $2.00 /M，缓存输入仅 $0.10 /M，写缓存（30 分钟）为 $2.50 /M，12 小时写缓存为 $5.00 /M。相比之下，较老的 GPT-4o 缓存折扣仅约 50%，而 GPT-6 系列可达 95% 以上。实际费用取决于您的提示前缀复用比例和缓存窗口选择。
核对清单
使用以下 checklist 快速验证您的账单是否符合官方 Prompt Caching 政策：
- [ ] 请求提示长度是否超过 1024 tokens（128 tokens 倍数）？
- [ ] 前缀（系统提示、工具定义、模式等）是否保持完全一致？（使用
allowed_tools而不改变 tools 数组可避免失效） - [ ] 是否在 30 分钟或 12 小时窗口内复用缓存？（响应 API 中通过
prompt_cache_key辅助路由） - [ ] 监控字段
cached_tokens是否正确显示？（usage.prompt_tokens_details 中） - [ ] 缓存写操作是否按 30 分钟/12 小时计费？（避免频繁写入导致超支）
- [ ] 命中率是否低于 70%？（建议调整提示结构以提升复用）
- [ ] 是否在数据本地化端点？（部分地区需额外 10% 费用）
运行一次测试请求，即可通过 API 响应中的 cached_tokens 和 prompt_tokens_details 完成自查。
风险与边界
缓存命中率受提示变化影响，任何前缀修改（如工具顺序调整、工具定义更新）都会导致缓存失效，导致账单骤升。长期运行的代理若无法稳定前缀，实际成本可能接近标准输入价，而非预期折扣。过度依赖缓存可能掩盖提示工程问题，最终引发对账单不匹配。
重要免责声明：以上信息基于 OpenAI 官方定价页和开发者指南，旨在供读者参考。实际账单以您账号的 OpenAI API Dashboard 为准，具体以 2026 年 11 月 1 日官方数据为准。OpenAI 保留调整定价的权利，本文非法律意见，不构成任何商业承诺或保证。
站内路径
延伸阅读
风险与边界（重复提醒）
缓存并非万能，提示长度不足或前缀不稳定将导致全价计费。建议在生产环境先做小规模测试，验证命中率后再大规模启用。本文仅供学习参考，非对账单替代工具，请以官方 Dashboard 为准。