积分余额与流水

用途

查看整数积分余额、批次状态和不可变流水，并理解任务冻结与结算结果。

使用前准备

普通用户初始积分为 0。管理员账户调用模型时为无限积分模式：系统仍保存 ADMIN_EXEMPT 账务记录和应计费用，但不会冻结或扣减积分。

操作步骤

配图占位：积分账户的余额卡片、批次和流水列表。

打开个人积分页面查看可用、冻结、已消费和已冲正余额，并在“积分使用记录”查看模型、修订版本、应计积分、状态和时间。
普通用户的已结算记录是实际扣除积分；仍在运行的记录显示冻结预估，释放后不计费。
管理员在“用户与积分”打开用户详情和“积分管理”，可查看同一套模型使用记录；管理员调用显示“管理员豁免”和应计积分，但不会扣减余额。普通用户还可按类型分页查看底层积分流水。

结果与状态

积分余额分为可用、冻结、已消费和已冲正四类。提交模型任务时，Task 与 BillingRun 在同一数据库事务创建，系统按最早到期、最早创建的顺序冻结可用批次；任务去重会复用原 BillingRun，价格维度的 JSON 键顺序不同也不会重复冻结。任务失败、取消或入队失败会释放冻结。同步模型调用也会先建立 BillingRun，并优先使用客户端 Idempotency-Key 保证重试只产生一次账务效果；个人助手的流式多步调用同样会先冻结，并在流完成后按各步骤汇总 Token 与请求次数结算。任务产生最终有效结果后，系统先持久化实际用量，再按提交时保存的模型修订和价格快照结算；进程异常恢复不会用估算值冒充实际值扣费。每次应用层供应商尝试还会保存独立运营成本流水：成功尝试按实际用量计算，失败重试按冻结时估算用量记录；这些成本只用于运营审计，不会额外扣用户积分。未使用的冻结额自动退回，供应商失败结果会保存不可计费原因并释放冻结。智能剪辑、字幕轨生成、智能裁切等不调用模型的本地任务不创建 BillingRun。

权限和边界

所有积分、单价和用量通过十进制整数字符串传输，不接受小数或指数格式。文本模型的输入与输出 Token 分别按实际用量占计价单位的比例计算，再各自向上取整为整数积分；使用不足 100 万 Token 不会按整个 100 万 Token 收费。音视频请求时长必须为正整数秒，供应商返回的小数媒体时长按秒向上取整。可使用 GET /api/user/points 查看自己的账户汇总、最近批次、不可变流水和模型使用记录；管理员使用 GET /api/admin/points?userId=<用户ID>&view=usage 分页查询指定用户（包括管理员）的模型使用记录。管理员还可在「用户与积分」按幂等键人工发放积分；只有完全未冻结、未消费的完整批次才能冲正。

常见问题

为什么任务完成后退回了一部分积分？

提交时按最大用量和安全余量冻结，结算只消费最终有效结果的实际费用。

为什么积分足够但任务提示供应商余额不足？

用户积分和模型供应商账户余额是两套额度。系统会释放本次冻结积分；管理员需要在对应供应商（例如 StarRouter）补充余额或切换可用模型后重新生成。