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