GPT-4o Mini 缓存分块（Tiling）计费陷阱：为什么你的账单比预期贵

GPT-4o Mini 缓存分块（Tiling）计费陷阱：为什么你的账单比预期贵

GPT-4o Mini 的 Prompt Caching 在提示词达到 1024 tokens 后自动生效，缓存按最长前缀匹配、以 128-token 增量分块（tiling），命中部分按半价计费。适用人群是直接调用 OpenAI 官方 API、需要核对账单与有效 $/M 的开发者或财务人员。决策方式很简单：先看 usage 里的 cached_tokens，再对照官方挂牌价算出真实单价，而不是凭“大概能省一半”估算。

OpenAICN 作为 OpenAI / 官方 API 计费对照站，这篇只服务一件事：帮你把账单对清楚，分清缓存命中与未命中，避免把 Plus 订阅和 API Token 费用混在一起。

现状与数据更新

截至 2026 年 9 月，官方公开的 GPT-4o Mini（gpt-4o-mini）文本 Token 挂牌价仍为：

类型	单价（$/M tokens）	说明
输入（未缓存）	0.15	标准 input
输入（缓存命中）	0.075	50% 折扣
输出	0.60	无缓存折扣

数据来源以 OpenAI 官方定价页当日为准。Prompt Caching 对 GPT-4o Mini 自动开启，无需额外参数。触发条件是提示词 ≥1024 tokens；系统会缓存最长公共前缀，并以 128-token 为步长向上取整分块。

典型陷阱出现在这几处：

• 前缀不精确匹配。任何早期变动（系统提示微调、工具定义顺序变化、图片 token 插入）都会打断缓存链，导致大量 token 按全价计费。
• 分块粒度。假设总输入 1500 tokens，最长可缓存前缀可能是 1024 + 3×128 = 1408，而不是全部；剩余按全价。
• 缓存存活时间。闲置约 5–10 分钟后可能失效，最长通常不超过 1 小时（部分新模型支持更长保留，但以当日文档为准）。间歇性流量容易“看起来该命中却没命中”。
• 账单呈现。usage 字段里有 cached_tokens，但很多中间层或日志只报总 prompt_tokens，导致对账时误以为全是半价。

结果是：你按“输入全半价”做预算，实际有效输入单价往往落在 0.09–0.14 $/M 之间，账单自然比预期高。

要快速自查，请直接对照 官方 API 价格 与 官方 API 说明。

核对清单

做完一轮调用后，按下面顺序核对，通常 5 分钟内就能定位差额：

1. 取出当次响应的 usage：prompt_tokens、completion_tokens、cached_tokens（或 input_tokens_details.cached_tokens）。

2. 计算未缓存输入 = prompt_tokens − cached_tokens。

3. 用挂牌价核算：

- 未缓存输入成本 = 未缓存数量 × 0.15 / 1_000_000

- 缓存输入成本 = cached_tokens × 0.075 / 1_000_000

- 输出成本 = completion_tokens × 0.60 / 1_000_000

4. 与账单明细对比。若差额超过 5%，检查是否有图片 token、工具调用附加费或中间层加价。

5. 确认提示词结构：静态内容（系统指令、工具 schema、示例）是否放在最前面，变量内容是否放在最后。

6. 观察请求间隔。若两次相同前缀请求间隔超过几分钟，缓存可能已清除。

7. 记录有效单价 = 总费用 / 总 token 数 × 1_000_000，再与 0.15/0.075/0.60 对照。

建议把上述步骤固化进对账脚本，或直接使用站内 计费路径说明 与 示例 中的核对模板。

风险与边界

缓存分块机制本身是官方设计，目的是降低重复前缀成本，但存在明确边界：

• 不是所有请求都能命中。短于 1024 tokens 的提示词完全不享受折扣。
• 精确前缀匹配要求严格，任何前缀漂移都会让分块失效。
• 缓存不跨组织共享，也不保证永久保留。
• 图片、音频、工具返回内容会改变 token 组成，可能削弱文本前缀的命中率。
• ChatGPT Plus / Team 订阅费用与 API Token 计费完全独立，不能用订阅额度抵扣 API 账单。

本文仅供技术对账参考，不构成法律、财务或投资意见。实际费用以 OpenAI 官方账单及当日挂牌价为准。若出现异常扣费，请优先通过官方支持渠道核对 usage 原始数据。

站内路径

对账单时建议按这个顺序走：

• 先查 官方价格 确认挂牌 $/M。
• 再看 官方 API 了解缓存规则与 usage 字段。
• 需要中转或链路核对时参考 API 中转说明。
• 完整对账流程见 计费路径。
• 具体数字示例在 示例。
• 更多指南汇总在 指南目录。

把缓存命中率、分块步长和有效单价写进自己的监控，比事后惊讶“账单怎么贵了”更省事。

延伸阅读

• 想直接对照最新挂牌价，可查看 官方 API 价格页。
• 需要理解缓存字段与账单明细对应关系，推荐阅读 官方 API 说明 与 计费路径。
• 具体调用示例与对账模板见 示例页。
• 更多关于 Token 单价与路径选择的内容，可浏览 指南目录 以及 API 中转相关说明。