Skip to content
角色设定板(Character Model Sheet)

角色设定板(Character Model Sheet)

本文属于“当前架构”,描述 v1.2.0 角色设定板已落地的实现。 单张正面全身定妆照仍保留为身份母版;角色设定板是独立的展示/管理母版。

1. 产物边界

最终交付是一张 16:9 设定板,不是多张图。当前提供两种生成方式,由创建请求的 generation_mode 选择:

方式generation_mode产物特点
分面板生成后合成panels(默认)12 张面板 → 后端合成中/英文板稳定、文字和标尺可控、可单面板重抽;约 12 张图
一次性整板oneshot1 张模型直接绘制的 16:9 整板快、构图更艺术化;文字/细节一致性较弱,必须人工审核

分面板合成

AI 生成 12 张面板图
  → 5 个全身视图
  → 6 个头部研究
  → 1 个电影感肖像
后端按固定模板合成
  → 中文版(工作台展示/审核)
  → 英文版(提交 MiniMax)

两版共用同一批面板图;英文版只重新绘制文字,不再调用图片模型。

一次性整板

角色档案 + 项目风格 + 可选参考图
  → 1 条整板提示词
  → 1 张 16:9 设定板
  → 同一张图作为中/英文入口的视觉母版

一次性整板把“主视觉 + 辅助视角 + 表情 + 细节 + 剪影 + ID 块”全部交给图片模型一次绘制。它不经过 Pillow 合成,因此没有独立面板可重抽;重新生成会整张重绘。

2. 面板清单

全身视图

  • body_front / 正面
  • body_three_quarter / 四分之三
  • body_side / 侧面
  • body_back / 背面
  • body_rear_three_quarter / 后四分之三

头部研究

  • head_front_neutral / 正面中性
  • head_three_quarter / 四分之三
  • head_profile / 侧面
  • head_top_down / 俯视
  • head_low_angle / 仰视
  • head_dynamic_intense / 动态强烈

其他区域

  • cinematic_portrait / 电影感肖像
  • 服装拆解:4 个材质/颜色色块
  • 细节标注:从已有面板裁切 3–5 个
  • Production Notes:年龄、身高、体型、职业、性格、习惯/随身物、连续性备注、自定义备注
  • Height Scale:身高刻度 + 人物剪影

3. 生成编排

分面板模式

  1. create_character_sheet 创建板与 12 个面板,只 stage body_front;
  2. body_front 成功后,advance_character_sheet stage 其余 4 个全身视图 + head_front_neutral;
  3. head_front_neutral 成功后,stage 其余 5 个头部 + 电影感肖像;
  4. 面板全部成功后,compose_character_sheet 下载面板图,渲染中/英文两块板;
  5. 面板失败时板状态为 partial,用户可单面板重抽;
  6. 单面板重抽成功后自动重新合成。

一次性整板模式

  1. create_character_sheet 只创建一个 oneshot_board 面板,直接 stage 16:9 图片任务;
  2. 提示词包含角色身份锚点、已绑定服装、项目锁定风格、参考图说明、版式、一致性锁定、文字设计和负面约束;
  3. 任务成功后 advance_character_sheet 直接把面板图写为 file_id_zh / file_id_en,状态置为 succeeded 并设为当前母版;
  4. 失败时整板状态置为 failed;重新生成会重绘整张板,不进入合成流程。

3.1 造型版本与参考图

设定板可以按角色的某个造型版本生成:

  • appearance_version_id 指定造型版本;为空时使用基础造型;
  • 造型版本通过 attributes.costume_id 绑定服装;
  • reference_file_id 指定参考图,通常来自「图片候选」抽卡结果;
  • 未显式选择参考图时,按“该造型已采纳候选图 → 角色正面图”回退;
  • 后端会校验参考图归属,避免跨角色复用。

这样同一角色可以生成多块设定板:基础造型、晚宴造型、十年前造型等。前端入口与换装流程见 角色换装与造型版本。

4. 数据模型

character_sheets

  • project_id / character_id
  • layout_version
  • generation_mode:panels / oneshot
  • appearance_version_id:按哪个造型版本生成
  • reference_file_id:设定板参考图
  • status:draft / generating / composing / succeeded / partial / failed
  • file_id_zh / file_id_en
  • is_current
  • height_cm
  • production_notes
  • error

character_sheet_panels

  • sheet_id
  • panel_key(一次性整板固定为 oneshot_board)
  • panel_type:body / head / portrait / board
  • status:pending / queued / running / succeeded / failed
  • file_id
  • generation_task_id
  • prompt
  • generation_params
  • sort_order
  • error

角色字段

characters 新增:

  • height_cm
  • occupation / occupation_en
  • body_type_en
  • personality_traits / personality_traits_en
  • habits / habits_en
  • continuity_notes / continuity_notes_en
  • production_notes / production_notes_en

英文板优先使用 *_en 字段;为空时回退中文值。

5. 中文/英文合成

backend/app/services/studio/character_sheets.py 使用 Pillow 绘制:

  • 16:9 画布(3200×1800);
  • 深灰背景;
  • 5 个全身窄列 + 左侧身高标尺;
  • 底部 6 个头部研究;
  • 右侧电影肖像、制作备注、细节标注、服装拆解、身高剪影;
  • 中文版标题/标签用中文,英文版用英文;
  • 文字、色块、刻度全部代码绘制,不交给图片模型。

字体:

  • 容器镜像安装 fonts-noto-cjk;
  • 中文优先 Noto Sans CJK,英文回退 DejaVu Sans。

6. 适用范围与费用控制

当前版本采用单角色手动触发:

  • 生成入口在角色详情页,只有用户选择生成方式并点击生成才会创建任务;
  • 不存在自动批量生成,创建项目、提取剧本或新增角色都不会自动产生设定板费用;
  • 系统不按“是否有台词”自动筛选,NPC / 无台词角色是否生成由用户决定;
  • 分面板模式单角色约 12 张图,失败面板可单独重抽;
  • 一次性整板模式单角色 1 张图,速度快,但文字、比例和细节需要人工审核后再采纳。

“有台词角色必须生成 + 批量显式确认”仍属于待落地方案,见 角色设定板批量范围与费用控制计划。

7. API

方法路径说明
POST/studio/projects/{pid}/assets/character/{cid}/character-sheet创建设定板;请求体 generation_mode 选择 panels / oneshot
GET/studio/projects/{pid}/assets/character/{cid}/character-sheet获取最近一块板
GET/studio/character-sheets/{sid}获取详情与进度
POST/studio/character-sheets/{sid}/panels/{key}/regenerate单面板重抽
POST/studio/character-sheets/{sid}/compose重新合成中/英文板
POST/studio/character-sheets/{sid}/adopt采纳为当前展示母版

8. 当前边界

  • 设定板不替代单张身份母版;身份锁定仍使用 identity_version_id 与正面图;
  • 分面板模式的服装拆解默认使用服装资产标签/描述;没有服装数据时使用通用“上衣/下装/鞋履/配饰”色块;
  • 分面板模式的细节标注从已有面板裁切,不单独生成图片;
  • 分面板模式的英文板未提供英文备注时回退中文,不自动翻译;
  • 一次性整板的中英文入口复用同一张图,文字由模型一次绘制,不保证英文标签完全正确;
  • 一次性整板不能重抽单个视角;/compose 对一次性整板返回 409;
  • 生成成本:分面板约 12 张图/角色,一次性整板 1 张图/角色;当前无批量入口,只有单角色手动触发;
  • 有台词角色强制清单与批量确认尚未实现,计划见 角色设定板批量范围与费用控制计划。