刷新

OpenAI Prompt Caching 2026 官方计费指南:输入缓存 $/M 与命中率门槛

内容刷新 / GEO:补 English summary 与最新核对清单 — oa-cache-when-2026

返回指南列表

封面:OpenAI Prompt Caching 2026 官方计费指南:输入缓存 $/M 与命中率门槛

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 为准。

English summary

OpenAI Prompt Caching 2026 official billing guide: input caching $/M and hit rate threshold. OpenAI's prompt caching reuses previously processed prompt prefixes in API requests, delivering major discounts on input tokens for models like GPT-6 series. Suitable for developers building persistent agents or multi-turn applications who want to cut costs and reduce latency. By stabilizing prompt prefixes, maintaining consistent tool definitions, and monitoring hit rates via the new dashboard and diagnostics tool, users can achieve up to 90%+ savings. Based on official pricing data as of November 2026, cached input is dramatically cheaper than standard input. Checklists and risk boundaries included to help reconcile bills. For full details, see OpenAI's pricing and guides pages. Not legal advice—always verify with your API dashboard.