# 调用费用与缓存计费

来源: https://platform.lyrouter.com/ai_gateway/docs/estimate
更新日期: 2026-10-22

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

## Token 的四个计费项

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

| 日志中的名称 | 含义 | 价格表中对应的列 |
| --- | --- | --- |
| 输入（缓存未命中） | 本次输入中没有命中上游提示词缓存、需要重新计算的部分 | 「输入」 |
| 输入（缓存命中） | 命中上游提示词缓存的输入 | 「输入（缓存命中）」；没有单独标价时按「输入」 |
| 输出 | 模型生成的 Token，包括思考（推理）过程 | 「输出」 |
| 显式缓存创建 | 通过 `cache_control` 写入上游缓存的输入，只在 Anthropic 协议的上游出现 | 「显式缓存创建」；没有单独标价时按「输入」 |

- **输入要拆开算**：「输入（缓存未命中）」加「输入（缓存命中）」是这次调用的全部输入。OpenAI 兼容响应里的 `prompt_tokens` 通常已经包含缓存命中部分，估算时先减去命中量，再分别乘两种单价，不要把命中部分再按输入单价算一遍。
- **两个合计不同**：「Token 消耗」的「总计」是四项之和；日志列表的「总 Token」和详情的「Token 总量」是输入加输出，不含「显式缓存创建」，所以可能比「总计」小。
- **在列表中查看**：日志列表默认只显示「总 Token」，可以在「自定义列」中打开「输入（缓存未命中）」「输入（缓存命中）」「输出」和「费用」；「显式缓存创建」只在详情中显示。

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

## 估算一次调用的费用

1. 在工作空间的 **模型广场** 中打开模型，进入「服务商与价格」，找到要使用的来源。平台通道看「平台价」；「BYOK 参考价」「官方参考价」只供比较，不是平台扣费价。
2. 确认价格单位。文本模型通常是「/ 百万 Token」，图片、视频、语音可能按「张」「秒」「分钟」「万字符」「次」计价。
3. 按表格的「适用条件」找到这次调用落在哪一行，再按下式计算：

```text
费用 = 输入（缓存未命中） × 输入单价
     + 输入（缓存命中）   × 输入（缓存命中）单价
     + 输出              × 输出单价
     + 显式缓存创建       × 显式缓存创建单价
（按百万 Token 计价时，各项 Token 数先除以 1,000,000）
```

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

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

## 价格表上的计价条件

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

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

## 哪些调用会扣费

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

## 显式缓存的计费

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

上游使用 OpenAI 兼容协议时，网关会在发送前删除请求中的 `cache_control`，这时只有上游自动进行的隐式缓存，不产生「显式缓存创建」。标记规则和提高命中率的方法见[降低成本与优化缓存](https://platform.lyrouter.com/ai_gateway/docs/cost-practice)。

## 用日志和消费明细核对

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

金额对不上时的排查方法见[费用异常与缓存未命中](https://platform.lyrouter.com/ai_gateway/docs/cache-errors)，Credits 与订阅的规则见[计费规则与信用点](https://platform.lyrouter.com/ai_gateway/docs/billing)。

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