钱包与充值（余额怎么来、怎么扣、怎么对）
余额是什么、充值怎么入账、扣费为什么以 actual_cost 为准、常见不到账/扣费争议排查
MagicCore Fuel 的主线计费形态是 余额钱包：
- 你先把钱充进来（余额增加）
- 每次 API 调用产生用量（用量记录）
- 系统按用量扣费（余额减少）
对账时建议把“钱包”理解成一个很传统的记账本（流水账）：
- 充值 / 兑换码 / 活动赠送：记一笔“入账”
- 每条用量扣费：记一笔“出账”
- 退款 / 补偿：再记一笔“入账/冲正”
余额的常见来源
- 现金充值（订单/支付）
- 兑换码/活动赠送（如平台启用）
充值流程（通用）
- 进入控制台的充值页面
- 选择充值金额/套餐（如果有）
- 完成支付
- 回到控制台查看余额变化（必要时刷新）
对账口径：为什么扣费以 actual_cost 为准？
Fuel 的用量记录里通常会同时出现两类“成本字段”：
total_cost：基础成本（不含 VIP/SVIP 折扣，也不含某些模型倍率）actual_cost：最终扣费金额（余额/订阅真正扣的就是它）
所以你做钱包对账时：
- 余额扣减：用
actual_cost汇总 - 成本结构分析：用
input_cost / output_cost / cache_*_cost / image_output_cost+total_cost分析“钱花在了哪里”
直觉解释：
total_cost更像“原价”，actual_cost才是“你实际支付的价格”。
订阅与余额的区别（如平台提供）
有些账号会同时存在「余额钱包」和「订阅额度」。对账时把它们分开看：
- 余额：看余额流水与扣费记录是否一致
- 订阅：看订阅额度的消耗是否符合预期
具体展示与口径以控制台为准。
常见问题
充值成功但余额没变
优先按顺序排查：
- 是否支付在新窗口完成但你没回跳（先刷新页面）
- 是否支付渠道延迟回调（等 1~3 分钟）
- 订单状态是否仍在“处理中/待确认”
余额扣得太快
最常见原因：
- 模型换贵了（价格表的 Official/Final 价差异很大）
- 输出 token 很多（长输出成本非常快）
- 客户端超时后重试（一次逻辑请求变成多条 usage）
service_tier变成了priority（可能导致整条请求 2 倍计费，或使用 priority 专属单价）
排查建议：
- 先按
api_key_id聚合，找出异常 Key - 再按
model聚合，看是否某个模型异常突出 - 抽 1 条 usage 按
billing/overview页口径手算复核