发票、对账与争议处理
本文档说明计费记录如何产生、如何对账，以及遇到争议如何处理。
计费周期
Routic 按实际 token 消费计费，逐请求记录。计费链路如下：
- 请求 — 你使用 API Key 调用 API。
- 网关处理 — 网关路由到模型提供商并记录消费。
- 用量同步 — 同步 Job（约每 5 分钟）将网关消费日志拉入
usage_records。 - 扣费 — 计费 Job（约每 1 小时）从账户余额中扣除费用。
这意味着：
- 用量有短暂延迟 — 请求后最多 5 分钟才可见。
- 余额扣费不是即时的 — 在下一个计费周期内完成（最多 1 小时）。
- 控制台展示近实时数据 — 用量和余额视图自动刷新。
查看用量
在控制台中
Routic 控制台提供：
- 用量概览 — 按模型、按天的 token 消耗。
- 余额 — 当前账户余额和最近交易。
- API Key 用量 — 按密钥的消费明细。
通过 API
使用用量端点以编程方式查询消费。详见模型、SKU 与用量。
对账
什么是对账？
对账就是把你预期应被收取的费用与实际收取的进行对比。这对以下场景很重要：
- 预算跟踪 — 确保支出在预期范围内。
- 审计 — 验证每笔请求是否被正确计费。
- 争议解决 — 定位具体哪笔请求的收费有误。
如何对账
- 导出你的请求日志 — 从你的应用中导出包含
request_id、模型和时间戳的日志。 - 与用量记录比对 — 将每个
request_id与控制台或 API 中的用量数据匹配。 - 核对总额 — 汇总某个时间段内的 token 数和费用，与账单金额对比。
常见差异
| 差异 | 可能原因 | 怎么办 |
|---|---|---|
| 用量记录缺失 | 同步延迟（最多 5 分钟）或请求在记录前就失败了 | 等 5 分钟再查。如果还是缺失，联系支持。 |
| Token 数不一致 | 你的计数和模型提供商的 token 计数方式不同 | token 数由模型提供商的 tokenizer 决定，以响应中 usage 字段为准。 |
| 费用看起来不对 | 在模型提供商成本基础上加了加价 | 收费包含加价，参考费用对比了解定价背景。 |
| 重复扣费 | 重试不是幂等的——两个请求都被处理了 | Chat Completions 接口不是幂等的。非速率限制错误不要重试。详见错误与重试。 |
发票
当前状态
电子发票尚未在自助门户开放。发票开具规则如下：
| 发票类型 | 申请方式 |
|---|---|
| 人民币发票（普票/专票） | 联系支持，提供账单周期和公司信息。 |
| USD 收据 | 在控制台账单历史中查看。 |
| Proforma / Commercial Invoice | 联系支持获取跨境文档。 |
即将上线
以下发票能力正在规划中：
- 控制台自助申请发票
- 月度账单周期自动生成发票
- 下载历史和状态跟踪
争议处理
如果你认为某笔收费有误：
- 收集证据 — 记录
request_id、时间戳、预期费用与实际费用。 - 联系支持 — 提供上述信息和你的账户 ID。
- 处理时限 — 争议在 1–3 个工作日内审核。
常见的有效争议：
- 请求返回了 500 错误但仍被收费（token 可能并未消耗）。
- 同一个
request_id在用量记录中出现两次。 - 用量记录中的 token 数与原始响应的
usage字段不一致。