积分计费与管理员免计费
本文属于“当前架构”文档,描述当前已生效的积分计费实现。
计费范围
积分是个人工作区预算,不是公司共享工作区预算:
workspace.kind = personal:按任务预留/结算个人积分;workspace.kind = company_shared:不走个人积分,workspace_credit_snapshot返回(0, None);- 本地
ws-local是company_shared,项目内图片/视频生成不扣个人积分。
计费路径
| 媒体 | 入口 | 执行 | 默认单价 |
|---|---|---|---|
| 图片 | 资产候选图 / 批量图片 / 分镜帧图片 | image_task_runner | 3 积分/张 |
| 视频 | 镜头视频 / 视频批量 / 自由生成 | film/generated_video / free_generation / video_task_runner | 10 积分/秒 |
| 音频 | 语音生成 | audio_task_runner | 1 积分/秒 |
提示词优化在自由生成中额外 +5 积分/条。
预留与结算
credit_accounts 保存 balance 与 reserved:
创建任务前:balance -= amount, reserved += amount
任务成功:reserved -= amount,写 consume 流水
任务失败:balance += amount, reserved -= amount(task_id, media_type) 是幂等键,重试不会重复扣。余额检查使用原子条件更新,避免并发超扣。
平台管理员免计费
users.is_platform_admin = true 的账号视为无限制:
workspace_credit_snapshot返回(0, 当前余额),预检永远通过;resolve_task_billing返回None,不创建预留;- 任务成功/失败不会产生 consume/release;
- 余额数字保持不变,不会被消耗。
这条规则集中在 app/services/credits.py 的 is_admin_unlimited,图片、视频、音频和自由生成共用同一入口,避免只绕过某一个按钮。
本地 admin 账号已设置为平台管理员;其个人工作区 ws-admin-student 余额为 150,仅用于展示,不会因生成而减少。