角色设定板(Character Model Sheet)
本文属于“当前架构”,描述 v1.2.0 角色设定板已落地的实现。 单张正面全身定妆照仍保留为身份母版;角色设定板是独立的展示/管理母版。
1. 产物边界
最终交付是一张 16:9 设定板,不是多张图。当前提供两种生成方式,由创建请求的 generation_mode 选择:
| 方式 | generation_mode | 产物 | 特点 |
|---|---|---|---|
| 分面板生成后合成 | panels(默认) | 12 张面板 → 后端合成中/英文板 | 稳定、文字和标尺可控、可单面板重抽;约 12 张图 |
| 一次性整板 | oneshot | 1 张模型直接绘制的 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. 生成编排
分面板模式
create_character_sheet创建板与 12 个面板,只 stagebody_front;body_front成功后,advance_character_sheetstage 其余 4 个全身视图 +head_front_neutral;head_front_neutral成功后,stage 其余 5 个头部 + 电影感肖像;- 面板全部成功后,
compose_character_sheet下载面板图,渲染中/英文两块板; - 面板失败时板状态为
partial,用户可单面板重抽; - 单面板重抽成功后自动重新合成。
一次性整板模式
create_character_sheet只创建一个oneshot_board面板,直接 stage 16:9 图片任务;- 提示词包含角色身份锚点、已绑定服装、项目锁定风格、参考图说明、版式、一致性锁定、文字设计和负面约束;
- 任务成功后
advance_character_sheet直接把面板图写为file_id_zh/file_id_en,状态置为succeeded并设为当前母版; - 失败时整板状态置为
failed;重新生成会重绘整张板,不进入合成流程。
3.1 造型版本与参考图
设定板可以按角色的某个造型版本生成:
appearance_version_id指定造型版本;为空时使用基础造型;- 造型版本通过
attributes.costume_id绑定服装; reference_file_id指定参考图,通常来自「图片候选」抽卡结果;- 未显式选择参考图时,按“该造型已采纳候选图 → 角色正面图”回退;
- 后端会校验参考图归属,避免跨角色复用。
这样同一角色可以生成多块设定板:基础造型、晚宴造型、十年前造型等。前端入口与换装流程见 角色换装与造型版本。
4. 数据模型
character_sheets
project_id/character_idlayout_versiongeneration_mode:panels/oneshotappearance_version_id:按哪个造型版本生成reference_file_id:设定板参考图status:draft/generating/composing/succeeded/partial/failedfile_id_zh/file_id_enis_currentheight_cmproduction_noteserror
character_sheet_panels
sheet_idpanel_key(一次性整板固定为oneshot_board)panel_type:body/head/portrait/boardstatus:pending/queued/running/succeeded/failedfile_idgeneration_task_idpromptgeneration_paramssort_ordererror
角色字段
characters 新增:
height_cmoccupation/occupation_enbody_type_enpersonality_traits/personality_traits_enhabits/habits_encontinuity_notes/continuity_notes_enproduction_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 张图/角色;当前无批量入口,只有单角色手动触发;
- 有台词角色强制清单与批量确认尚未实现,计划见 角色设定板批量范围与费用控制计划。