计费与套餐

NexusKey 采用 预充值余额 + 按量扣费（PAYG） 模式：先为账户余额到账，调用按 Token 实时扣费，无月费、无最低消费。

余额钱包

• 每次 API 请求结束后，按本次请求的 Token 用量结算并从余额扣除；
• 结算口径：费用 = Σ(各类 Token 数 × 模型单价) × 生效费率倍率；
• 生效费率倍率 = 分组倍率（含用户级覆盖与峰时倍率），可通过 GET /v1/platform/billing 查询；
• 余额不足时请求会被拒绝（HTTP 402），请保持余额充足；网关在准入时还会按 max_tokens 做在途费用预留，并发高峰时建议预留更多余额。

Token 计费口径

Token 类别	说明
输入（未命中缓存）	按模型输入单价全价计费
缓存读取	命中上游提示缓存的输入 Token，按缓存读单价计费（通常低于全价）
缓存写入	写入上游提示缓存的输入 Token，按缓存写单价计费
输出	含推理 Token，按输出单价计费

流式中断

流式请求在 HTTP 200 之后仍可能因上游错误中断。中断请求按网关实际捕获到的 usage 结算；完全未产生 usage 的中断不计费。

充值方式

方式	说明
兑换码	控制台「兑换」页输入兑换码到账；适合对公转账/离线收款后由客服发码
在线支付	控制台「充值」页输入金额发起支付（微信/支付宝二维码或卡支付，以站点当前开通为准）

充值赠送

站点可配置充值赠送档位（如「满 50 赠 10%」）。赠送部分与本金同权计入余额，到账明细见「我的订单」。当前活动文案展示在充值页金额卡上方。

扣费示例

假设某模型输入价 $3 / 百万 Token、输出价 $15 / 百万 Token，分组倍率 1.0：

• 输入 1000 Token（无缓存）+ 输出 200 Token → 1000×3/1e6 + 200×15/1e6 = $0.006；
• 若其中 800 输入 Token 命中缓存读（假设 $0.3/百万）→ 200×3/1e6 + 800×0.3/1e6 + 200×15/1e6 = $0.00384。

账单与对账

• 控制台「使用记录」按请求展示 Token 明细与费用；
• GET /v1/usage 返回 Key 级用量摘要（today/total/每日序列/模型统计）；
• GET /v1/platform/billing 返回当前生效费率倍率，用于成本预测。

常见问题

• 余额会过期吗？ 不会，充值余额长期有效。
• 可以退款吗？ 未消耗本金部分按站点退款政策处理，赠送部分不可退；详见控制台公告或联系客服。
• 峰时倍率是什么？ 部分分组在高峰时段（控制台公示时段）应用额外倍率，/v1/platform/billing 返回 peak_* 字段说明当前配置。