用量、账单与发票（对账指南）

这页回答三件事：

1. 用量明细怎么看（按 Key / 模型 / 时间定位问题）
2. 扣费金额怎么来的（定价 * token * 综合倍率）
3. 财务凭证怎么留（订单/发票/收据）

用量明细（Usage）

建议用这三个维度排查：

• 时间：异常通常出现在某个时间段
• Key：泄露/误用通常集中在某个 Key
• 模型：有的模型输出长、成本非常快

对账口径（照着算就能对齐）

Fuel 的用量明细里，最关键的两列成本是：

• total_cost：基础成本（不含 VIP/SVIP 折扣，也不含某些模型倍率）
• actual_cost：最终扣费金额（余额/订阅实际扣的就是它）

你要做的对账，本质就是验证：

• 你能否用「token 数 + 单价」复算出 total_cost
• 你能否用 total_cost 再乘上相关倍率复算出 actual_cost

你需要抽样复算的一条记录，至少要看这些字段

• 身份维度：
  • api_key_id（是不是某个 Key 异常）
  • request_id（是否因为重试出现多条）
  • created_at（时间点）
• 模型维度：
  • requested_model（你请求的模型）
  • model / upstream_model（可能的映射结果；不同平台部署可能字段含义略有差异）
  • billing_mode（token / per_request / image）
  • service_tier（priority / flex / 空）
• token 与计费明细：
  • input_tokens
  • output_tokens
  • cache_creation_tokens
  • cache_read_tokens
  • cache_creation_5m_tokens、cache_creation_1h_tokens（如果启用）
  • image_output_tokens（如果有多模态输出）
• 成本字段：
  • input_cost / output_cost / cache_creation_cost / cache_read_cost / image_output_cost
  • total_cost
  • rate_multiplier
  • actual_cost

如果你只想快速判断“VIP 是否生效”，看 rate_multiplier 与 actual_cost 就够；
如果你要定位“为什么扣这么多”，必须把 token 与各子项成本都拉出来看。

抽样对账步骤（推荐 5 分钟版）

1. 圈定时间段：只看异常发生前后 10~30 分钟。
2. 按 Key 聚合：看某个 api_key_id 是否异常突出。
3. 抽 1 条最异常的 usage：打开这条记录的全部字段。
4. 确认计费模式：先看 billing_mode（token / per_request / image）。
5. 复算 total_cost：
   • token 模式：按 overview 页的公式，把 input/output/cache/image 分开算
   • per_request/image 模式：确认 unit_price 与次数（request_count / image_count）
6. 复算 actual_cost：
   • 任意模式：先算 综合倍率 = actual_cost / total_cost（最快）
   • 如果你明细里有 rate_multiplier：再判断“综合倍率”和你的会员折扣是否一致
7. 结论归因：如果数对不上，90% 的问题在下面三类：
   • 你用错了价格（用了 Final 当 Official，或反过来）
   • 你的 service_tier 不同（导致 total_cost 口径不同）
   • 同一逻辑请求发生了重试（出现多条 usage）

余额变动（Wallet）

用“余额流水”去核对：

• 充值入账
• 扣费出账
• 退款/补偿（如果有）

订单与发票（Invoices）

如果你是企业/团队报销场景：

• 建议每次充值都保留订单号与支付凭证截图
• 如平台提供发票/收据下载入口，以平台入口为准

口径建议：报销时以「订单金额/支付凭证」为准；技术对账以「用量明细 actual_cost 汇总」为准。两者通常不完全一致（因为充值≠消耗，且可能存在赠送/兑换码/退款/补偿等流水）。