API Token 费用计算与账单核对
根据请求的实际 usage 和 API Key 分组单价计算费用,包括缓存读取与写入。本指南提供计算方法和可复现的对账步骤;数字示例仅用于演示,不是 FlyRouter 实测结果或当前报价。
更新日期:
一笔 Token 账单包含什么
| 类别 | 统计内容 |
|---|---|
| 普通输入 | 未计入缓存读取或写入的输入 Token |
| 输出 | API 返回的计费输出 Token |
| 缓存读取 | 从已有缓存读取的 Token |
| 缓存写入 | 写入缓存的 Token;不同有效期应按各自价格分开统计 |
每类费用为 Token 数 × 每百万 Token 美元单价 ÷ 1,000,000,然后相加。如果输入总数已经包含缓存 Token,不能再重复叠加。不同协议的 usage 字段定义不同,归一化前应检查实际响应格式。
使用假设单价的计算示例
假设一次请求包含 10,000 普通输入、40,000 缓存读取和 2,000 输出 Token,对应单价分别为每百万 $1、$0.10、$5,且没有缓存写入。
| 类别 | 计算 | 费用 |
|---|---|---|
| 普通输入 | 10,000 × 1 ÷ 1,000,000 | $0.010 |
| 缓存读取 | 40,000 × 0.10 ÷ 1,000,000 | $0.004 |
| 输出 | 2,000 × 5 ÷ 1,000,000 | $0.010 |
| 合计 | 相加 | $0.024 |
相同用量的 100 次请求为 $2.40。这不代表 Agent 连续 100 轮的费用一定相同:历史会增长、缓存会过期、重试会增加请求。可在成本计算器中输入实际单价。
核对一条真实请求
- 记录时间、模型 ID、请求 ID 和密钥计费分组,不公开密钥。
- 保留原始 usage,包括不同有效期的缓存写入和计费思考 Token;若思考已包含在输出中,不重复计数。
- 找到控制台对应记录,核对请求发生时的单价。当前价格不能证明历史扣费。
- 选择正确的输入长度档位或分时价格,各项单价来自同一个分组,不能拼接多个组的最低价。
- 保留计算精度到最终展示,再与扣费核对。无法解释的差异可携请求 ID 联系支持。
公平比较首次与缓存命中请求
固定模型、线路、提示词、输出预算和工作负载,逐条记录缓存读写。报告样本量、时间窗口、成功与失败次数、总支出和任务完成情况。仅发布脱敏记录。输入单价更低,不一定意味着完成同一任务的成本更低。