Skip to content
积分计费与管理员免计费

积分计费与管理员免计费

本文属于“当前架构”文档,描述当前已生效的积分计费实现。

计费范围

积分是个人工作区预算,不是公司共享工作区预算:

  • workspace.kind = personal:按任务预留/结算个人积分;
  • workspace.kind = company_shared:不走个人积分,workspace_credit_snapshot 返回 (0, None);
  • 本地 ws-local 是 company_shared,项目内图片/视频生成不扣个人积分。

计费路径

媒体入口执行默认单价
图片资产候选图 / 批量图片 / 分镜帧图片image_task_runner3 积分/张
视频镜头视频 / 视频批量 / 自由生成film/generated_video / free_generation / video_task_runner10 积分/秒
音频语音生成audio_task_runner1 积分/秒

提示词优化在自由生成中额外 +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,仅用于展示,不会因生成而减少。