API token 计费怎么算：输入、输出、缓存读写与批处理折扣

价格 · 发布于 2026-11-11 · 更新于 2026-11-12 · YYSI 编辑部 · English

先说结论

API 账单由四条价格线构成：输入 token、输出 token、缓存读取和（部分厂商的）缓存写入，外加可选的批处理折扣。坑不在算术，而在假设每家对修饰项的实现相同——它们并不同：有的对写缓存收溢价（Anthropic，以及 OpenAI 经 Responses API 的 GPT-5.6 及以后模型），有的只对读取打折（更早的 OpenAI 模型、DeepSeek），有的对隔夜批处理全线五折（OpenAI、Anthropic），另一家按时间段半价（DeepSeek 错峰）。本指南给出一个公式、三个已知答案算例、以及会改变结果的各家规则——费率于 2026-11-11 在官方页面核实，2026-11-12 复核并记录两处更正。

公式与单位

请求成本 = (新输入 x 输入价) + (缓存命中 x 读价) + (新写入 x 写价) + (输出 x 输出价)
         除以 1,000,000   [价格按每百万 token]

新输入   = 未命中缓存也非本次写入的输入 token
缓存命中 = 命中已有缓存的输入 token（按读价计费，替代输入价）
新写入   = 本次请求存入缓存的输入 token（按写价计费，同样是替代而非叠加）

三条单位规则能避免大多数计费困惑。主流厂商价格按每百万 token——"每千 token"的报价比较前先乘 1,000。token 不是字符（中文大约每字 1–2 token，取决于各家分词器，确切切分由厂商决定）。缓存读取替代输入计费——8,000 个前缀 token 命中缓存时，只按读价计费，不再按新输入价重复计费。

教学费率卡算例（假设）

为了算术清晰，先用一个虚构厂商 ExampleU：输入 $3/1M、输出 $15/1M、缓存写入 1.25x = $3.75/1M（5 分钟 TTL）、缓存读取 0.05x = $0.15/1M、Batch 50%（次日出结果）。这些费率是教学虚构；真实核实版紧随其后。

算例一——无缓存

一次请求：输入 10,000 token、输出 2,000 token，无缓存。

10,000 x $3    = $0.0300   （输入）
 2,000 x $15   = $0.0300   （输出）
               ------------
                 $0.0600

已知答案：$0.06。如果整月发送相同请求，每次都是 $0.06——前缀没有被复用之前，缓存什么也改变不了。

算例二——先写缓存，再读缓存

同样的请求，但 10,000 输入中有 8,000 是稳定的指令前缀。第一次请求把它们写入缓存；之后的请求读缓存。

写请求：2k 新输入 x $3 + 8k x $3.75（写入）+ 2k 输出 x $15
      = $0.006 + $0.030 + $0.030 = $0.0660   （比无缓存 +$0.006）
读请求：8k x $0.15（读取）+ 2k 新输入 x $3 + 2k 输出 x $15
      = $0.0012 + $0.006 + $0.030 = $0.0372   （比无缓存 −$0.0228）

已知答案：写请求 $0.0660——被写入的 token 按写价计费并替代输入价，所以写缓存只多付 25% 溢价（$0.006）；每个读请求 $0.0372。溢价小于一次读取的节省，所以缓存第一次被复用就回本。两条规则要分清：写入只收一次（绝不按请求重复收）；读取的节省只在缓存存活期内有效——5 分钟 TTL 过期后，下一次请求要重新付费写入。1 小时 TTL（此处为 2x 输入价）用更高溢价买更长的窗口。

算例三——批处理折扣，以及什么不能叠加

1,000 份没人要求实时的摘要：每份 4,000 输入 + 1,000 输出。

单次：4k x $3 + 1k x $15 = $0.027
1,000 次：标准价 $27.00 -> Batch（50%）$13.50

已知答案：标准价 $27.00，Batch $13.50。折扣不能这样用：交互式请求用不了 Batch（结果按设计次日返回）；DeepSeek 的错峰折扣是时段价格，不是批处理 API——不能与别家的批处理折上折，"OpenAI batch 对比 DeepSeek 错峰"之所以公平，是因为两者都适用于可延迟的工作负载，而不是因为机制相同；缓存写入绝不能按请求重复计费——这个建模错误会让缓存类工作负载每次请求虚增约 25%。有官方依据的叠加有两组：OpenAI 的 Batch 对每类 token 按标准价 50% 计费，缓存输入也包含在内，因此 Batch 内的缓存输入为 $0.05/1M；Anthropic 官方定价 FAQ 也写明 Batch 与提示缓存折扣可以组合——见下方核实表。（本指南初版误称 Anthropic 这一组合无文档，2026-11-12 已更正。）

同例用今日核实的真实费率

下表所有费率均于 2026-11-11 读自厂商官方价格页，并于 2026-11-12 复核；请求形状与上文相同（10,000 输入 + 2,000 输出），各行可直接对比。当前快照请查看价格数据页或 model-prices JSON——厂商调价后请勿信任本表。

请逐行读这张表，不要竖着比：DeepSeek 在这个例子中单次最便宜，但没有批处理 API，且其页面以美元报价（YYSI hub 收录人民币价卡）；OpenAI 与 Anthropic 在本例中总价恰好相同、机制完全不同——OpenAI 靠便宜的缓存读取（该型号 0.05x）和减半的 Batch，但其 GPT-5.6 及以后模型还收缓存写入溢价，只有后续确实发生读取才回本；Anthropic 靠写入/读取模型且该型号读取是减价的 0.05x 而非通用 0.1x。同一工作负载、不同机制——这正是每次请求总价必须按厂商分别重算的原因。

会改变账单的各家规则（2026-11-11 核实，缓存规则 2026-11-12 复核）

• 缓存模型：DeepSeek 只对读取打折、无写入费、缓存自动管理。OpenAI 按模型代次区分：GPT-5.6 及以后（经 Responses API）收缓存写入价——默认 30 分钟 TTL 为输入价 1.25x、12 小时为 2.5x，写入替代该部分 token 的输入计费——读取多为输入价 0.1x，gpt-6.1-sol 为 0.05x（$0.10），且最短可缓存前缀为 1,024 个可见输入 token；更早的 OpenAI 模型无写入费。Anthropic 对写入收明确溢价（5 分钟 TTL 1.25x、1 小时 2x）、读取给减价——且 Sonnet 5.5 当前是 0.05x 而非通用 0.1x。TTL 内的读取会续期；过期后下一次请求重新付费写入。
• 批处理：OpenAI 与 Anthropic 均为 50%，适合等得起的工作负载——且两家都写明批处理与缓存折扣可叠加（OpenAI 对 Batch 内缓存输入按 50% 计价；Anthropic FAQ 写明可组合）。DeepSeek 则在错峰时段（夜间、周末、中国节假日）把常规价格减半——是调度折扣，不是独立 API。
• 长上下文：OpenAI 页面写明超过短上下文阈值后单价翻倍（gpt-6.1-sol：$4/$15），"Fast" 档再翻倍。先确认你的工作负载落在哪一档。
• 推理 token：OpenAI 文档写明推理 token "按输出 token 计费"——回复文本里看不见，账单里看得见，这就是为什么推理模型的"短"回答可能比看起来贵。预算请按输出计数器，不要按可见回答长度。
• 工具调用：多数厂商只收工具往返消耗的 token，但 DeepSeek 的 Search 与 Fetch API 按成功请求收费（每 1,000 次 $0.75），与 token 费并列。按次收费是另一种单位——绝不能混进每 token 费率。
• 币种与价卡口径：DeepSeek 官方页以美元报价（YYSI hub 收录人民币价卡）；每千与每百万报价相差 1,000 倍——比较厂商前先归一。

我们计算器能算什么、不能算什么

AI API 成本计算器计算基础公式：一个输入价、一个输出价、一个缓存命中价加一个缓存占比滑块——足以覆盖上文全部"无缓存"与"缓存读取"算例。它不能建模：缓存写入溢价、TTL 续期、Batch 开关、推理 token 的输出膨胀、按次工具费、每千报价。这些请用上方公式块手算——例如 Anthropic 式的首次请求，可以把计算器的输入价字段临时改成写入价来算；读请求把读价填进缓存字段。我们选择记录这些限制而不是加功能：计算器定位是通用价卡工具，厂商专用计费模拟器需要自己的测试，而且每次调价都会过时。如果某个功能你反复需要，请通过工具页的反馈框告诉我们。

信任任何账单之前的检查清单

1. 输入和输出是否分开计价？（必然分开。）
2. 厂商收缓存写入、只收读取、还是都收——写价的 TTL 如何续期？
3. 折扣是 Batch（延迟出结果）、错峰（时间窗），还是别的？只叠加厂商有文档依据的组合——OpenAI 与 Anthropic 都写明批处理可叠缓存；DeepSeek 错峰是时段价格，不可当批处理叠加。
4. 你的模型是否把推理/思考 token 按输出计费？把它算进去。
5. 价格是每百万还是每千？美元还是人民币？先归一。
6. 任何周期性付费之前，用价格数据页的当前费率重算一遍。

教学费率是假设；真实费率于 2026-11-11 在官方页面核实、2026-11-12 复核（两处更正已记录在上方与验证说明中），均附来源链接。每请求公式与我们的计算器一致，其支持的输入与已知限制已列于上文。