调用费用与缓存计费

一次文本调用的费用由四类 Token 分别计价后相加:「输入(缓存未命中)」按价格表的「输入」单价,「输入(缓存命中)」「输出」「显式缓存创建」按价格表中同名一项的单价。单价以工作空间 模型广场 中模型详情的「平台价」为准,长上下文分档、分时计价、服务档位等条件会改变适用的单价。只有成功的调用扣费,估算结果可以用请求日志的「费用」和 订阅充值 的「消费明细」核对。

Token 的四个计费项

日志详情「Token 消耗」把一次调用的 Token 分成四项,四项互不重叠:

日志中的名称 含义 价格表中对应的列
输入(缓存未命中) 本次输入中没有命中上游提示词缓存、需要重新计算的部分 「输入」
输入(缓存命中) 命中上游提示词缓存的输入 「输入(缓存命中)」;没有单独标价时按「输入」
输出 模型生成的 Token,包括思考(推理)过程 「输出」
显式缓存创建 通过 cache_control 写入上游缓存的输入,只在 Anthropic 协议的上游出现 「显式缓存创建」;没有单独标价时按「输入」
  • 输入要拆开算:「输入(缓存未命中)」加「输入(缓存命中)」是这次调用的全部输入。OpenAI 兼容响应里的 prompt_tokens 通常已经包含缓存命中部分,估算时先减去命中量,再分别乘两种单价,不要把命中部分再按输入单价算一遍。
  • 两个合计不同:「Token 消耗」的「总计」是四项之和;日志列表的「总 Token」和详情的「Token 总量」是输入加输出,不含「显式缓存创建」,所以可能比「总计」小。
  • 在列表中查看:日志列表默认只显示「总 Token」,可以在「自定义列」中打开「输入(缓存未命中)」「输入(缓存命中)」「输出」和「费用」;「显式缓存创建」只在详情中显示。

日志详情的 Token 消耗分四项列出数量和占比,基本信息中的费用是这次调用的实际扣费。

图 1:日志详情的 Token 消耗分四项列出数量和占比,基本信息中的费用是这次调用的实际扣费。 截图为演示数据,点击图片可查看原图。

估算一次调用的费用

  1. 在工作空间的 模型广场 中打开模型,进入「服务商与价格」,找到要使用的来源。平台通道看「平台价」;「BYOK 参考价」「官方参考价」只供比较,不是平台扣费价。
  2. 确认价格单位。文本模型通常是「/ 百万 Token」,图片、视频、语音可能按「张」「秒」「分钟」「万字符」「次」计价。
  3. 按表格的「适用条件」找到这次调用落在哪一行,再按下式计算:
费用 = 输入(缓存未命中) × 输入单价
     + 输入(缓存命中)   × 输入(缓存命中)单价
     + 输出              × 输出单价
     + 显式缓存创建       × 显式缓存创建单价
(按百万 Token 计价时,各项 Token 数先除以 1,000,000)

有权限查看折扣时,价格表会同时显示划线原价和折扣后的价格,按折扣后的价格估算。价格表中的「—」表示暂无报价,不代表免费。

模型详情的服务商与价格按来源列出平台价、计价方式和适用条件。

图 2:模型详情的服务商与价格按来源列出平台价、计价方式和适用条件。 截图为演示数据,点击图片可查看原图。

价格表上的计价条件

价格表标题显示计价方式,「适用条件」列显示每行单价的适用范围:

计价方式或条件 如何影响费用
固定单价 所有调用使用同一组单价
Token 长度计价 按单次请求的 Token 长度选档,整次请求都按该档单价计费。判断输入长度时使用全部输入 Token,包括缓存命中的部分,所以缓存命中率再高,长上下文请求也按长上下文档计价
分时计价 按请求发生的星期和时段乘以对应系数。时段含开始、不含结束,按价格表标注的时区判断;只区分星期几,不区分法定节假日和调休
条件计价 按服务档位、模态、分辨率、时长等条件选价。例如「服务档位」按上游实际使用的档位计价,「每次前 N … 免费」表示每次调用先扣除这部分数量再计费
复杂计价 页面提示「存在未完整展示的计价条件,请核对完整定价规则后使用。」,请联系支持确认后再估算

哪些调用会扣费

  • 只按成功的调用扣费:上游返回错误或连接失败的调用不扣费。网关自动换通道或改用备用模型时,只按最终成功的那一次计费,失败尝试的费用不会转给你,见失败重试与备用模型。
  • BYOK 调用:Token 费用由你直接与服务商结算,平台对每次成功调用扣一笔按订阅版本确定的平台服务费,日志「费用」显示的就是这笔服务费,见BYOK 费用与凭证管理。通过 BYOK 接入的 Coding Plan 按服务商套餐计费,不按 Token 单价结算,见API 按量服务与 Coding Plan。
  • 异步任务:视频等异步生成在任务完成后结算。创建任务的请求本身不产生费用,日志列表在结算前显示「结算中」,见多模态能力。

显式缓存的计费

在请求里用 cache_control 标记缓存断点、且这次调用由 Anthropic 协议的上游服务时,写入缓存的部分记为「显式缓存创建」,按「显式缓存创建」单价计费;Anthropic 的缓存写入单价高于普通输入。之后几分钟内发送相同前缀的请求,这部分记为「输入(缓存命中)」,按「输入(缓存命中)」单价计费。前缀会被反复使用时,写入的额外费用通常在一两次命中后就能收回。

上游使用 OpenAI 兼容协议时,网关会在发送前删除请求中的 cache_control,这时只有上游自动进行的隐式缓存,不产生「显式缓存创建」。标记规则和提高命中率的方法见降低成本与优化缓存。

用日志和消费明细核对

  • 日志「费用」:这次调用实际扣除的 Credits 折算成的人民币金额,在调用时按当时的价格计算并固定下来,之后调价不会改变历史日志的金额。显示「未计算」表示这次调用没有产生扣费,例如调用失败;显示「无权限查看」表示当前账号不能查看这条日志的费用。
  • 消费明细:当前账号管理员在 订阅充值 的「消费明细」中按请求查看「消费 Credits」,其中的「请求 ID」与日志详情顶部的 Request ID 相同,可以逐条对应。单次查询的时间范围不能超过 90 天,刚完成的调用可能要几分钟后才出现。

金额对不上时的排查方法见费用异常与缓存未命中,Credits 与订阅的规则见计费规则与信用点。

消费明细按请求列出时间、API Key、工作空间、模型和消费 Credits,可按请求 ID 与日志对应。

图 3:消费明细按请求列出时间、API Key、工作空间、模型和消费 Credits,可按请求 ID 与日志对应。 截图为演示数据,点击图片可查看原图。