OpenAI Prompt Caching 有效单价怎么算：命中后输入$/M 到底降多少
内容刷新 / GEO：补 English summary 与最新核对清单 — oa-openai-prompt-caching-effective-unit-price
ガイド一覧 · 本文は主に簡体字中国語です。国際向けの要点は English summary をご利用ください。
OpenAI Prompt Caching 有效单价怎么算：命中后输入$/M 到底降多少
OpenAI Prompt Caching 让你的 API 请求在提示前缀完全重复时，直接复用已缓存的计算结果，从而大幅降低输入成本。
这是专门服务需要多次调用相同系统提示、工具定义或长上下文的开发者（如构建 Agents、Claude Code 风格的工具链或自定义 Grok 对话流）的关键工具。
如果你在对账单时看到输入 Token 花费远低于全额单价，就是因为命中了缓存——官方定价中 Cached input 通常比普通 Input 便宜 80%–95%。
想知道命中后实际单价是多少？本文帮你拆解官方数据，配上可执行的计算方法和最新核对清单，直接用于你的 API 计费对比。
现状与数据更新
2026 年 10 月，OpenAI 已将 Prompt Caching 扩展到旗舰模型（gpt-6 系列、gpt-5.6 系列等），支持 Responses API 和相关 Agents 调用。
缓存写入（cache write）与读取（cache read）有独立定价：普通输入按全价，缓存命中输入按大幅折扣价，写入时按中间阶梯价（30 分钟或 12 小时有效期）。
最新官网定价（以 2026-10-21 发布数据为准）显示，部分旗舰模型的 Cached input 价格已降至普通 Input 的 1/10 甚至更低，例如：
- gpt-6.1-sol：普通输入 $2 /M，Cached input $0.10 /M（优惠 95%）
- gpt-5.6-sol：普通输入 $4 /M，Cached input $0.40 /M（90% 优惠）
这些折扣不是静态的，而是取决于你是否命中有效缓存以及缓存时长。实际到账单时，OpenAI 会按 input_tokens_details.cached_tokens 单独结算，普通输入则按剩余 Token 计费。
数据会随模型更新而变动，建议你定期比对官方价格页。
核对清单
使用以下清单逐项对照你的账单，确保命中率计算准确：
| 项 | 说明 | 建议操作 |
|---|---|---|
| 1. 确认命中 | 查看 API 响应 usage.input_tokens_details.cached_tokens 是否 > 0 |
在代码中打印或看 Dashboard |
| 2. 缓存时长 | 30 分钟 vs 12 小时写入 | 确保 prompt_cache_options 配置有效 |
| 3. 模型支持 | gpt-6 系列及以上才显示完整缓存字段 | 旧模型可能只有普通输入 |
| 4. 最小缓存长度 | 至少 1,024 tokens（GPT-5.6+） | 计算前缀长度，避免小段命中 |
| 5. 匹配前缀 | 系统提示、工具定义、历史上下文完全一致 | 修改任何一行都会 miss |
| 6. 实际单价 | Cached input × cached_tokens + 普通输入 × (total_input - cached_tokens) | 实时计算你的成本 |
| 7. Dashboard 检查 | 前往 Prompt Caching Dashboard 查看命中率 | https://platform.openai.com/usage?usage_section=prompt-caching |
实用计算公式（推荐用这个工具页辅助）：
总输入成本 =（普通输入 Token × 普通 $/M） +（缓存 Token × 缓存 $/M）
命中率 = 缓存 Token / 总输入 Token
例如：10,000 Token 输入，命中 4,000 Token（$0.10 /M 缓存价），则总价 =（6,000 × $2）+（4,000 × $0.10）= $12.60。
风险与边界
Prompt Caching 能显著降低成本，但前提是你的提示前缀必须高度稳定。如果任务逻辑、工具配置或上下文稍有变化，缓存就会 miss，导致实际支付接近全价甚至更高。
部分低价模型（如 gpt-5-nano）缓存折扣可能未完全生效，或写入价格不适用。
Regional processing 端点（数据驻留）会额外加 10% 费用。
这些边界仅供参考，不构成法律意见。建议始终以 OpenAI 官方定价和账单字段为准，勿依赖任何第三方计算。
站内路径
想更深入了解 OpenAI API 计费细节？
- 查看官方 API 定价总览：/official-api
- 查看完整价格表格与缓存字段：/official-prices
- 学习 API 计费路径：/billing-path
- 查看实际使用示例：/examples
- 掌握 token 计数指南：/guides
这些页面可直接关联到你的对账单计算场景。