可视化故事板(16:9 多格)
本文属于“当前架构”,描述已落地的可视化故事板 Phase 1。 AI 助手修改、逐格重抽等后续能力见 可视化故事板实施计划。
1. 产物与边界
- 产物是一张 16:9 横版故事板,不是正式镜头画面;
- 支持 6 / 9 / 12 格,默认 9 格;
- 支持黑白铅笔、黑白墨线、彩色草图三种风格;
- 故事板只读取分镜候选,不写回分镜行与正式镜头;
- 用户可以多次抽卡,采纳其中一张作为当前故事板。
2. 数据模型
storyboard_boards
draft_id:关联shot_plan_drafts;panel_count/style;prompt/extra_prompt/panel_snapshot;status:draft/generating/succeeded/failed;file_id:当前预览/采纳图;is_current:同一草稿只保留一块当前故事板;generation_task_id/error。
storyboard_board_candidates
board_id/file_id;status:pending/queued/running/succeeded/failed;prompt;generation_task_id;is_adopted;error。
3. 提示词构建
backend/app/services/studio/visual_storyboard.py:
- 读取
shot_plan_candidates,忽略review_status=ignored; - 按
order_index取前 N 行; - 每行提取标题、景别、角度、运镜、场景、角色、服装、动作、台词摘要、情绪;
- 生成 16:9 多格提示词:交付物 → 镜头内容 → 风格 → 标注 → 约束;
- 参考图优先取主要角色的当前设定板,其次角色正面图,最多 3 张。
风格块:
pencil:rough pencil, minimal detail, quick gesture, strong silhouette;ink:clean contour, light wash;color:flat cinematic color blocks。
标注只保留镜号与少量箭头,不把长台词放进画面。
4. 生成与任务回写
- 创建故事板时 stage 一个
storyboard_board_candidate图片任务; - 任务成功后由
image_task_runner回写候选file_id/status,并更新板状态与预览图; - 任务失败时回写候选与板的
error; - 采纳候选只更新
is_adopted/is_current/file_id,不触发重新生成。
5. API
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /studio/storyboard/{draft_id}/boards | 列出故事板与候选 |
| POST | /studio/storyboard/{draft_id}/boards | 创建故事板并生成第一张 |
| POST | /studio/storyboard/boards/{board_id}/candidates/generate | 再抽一张 |
| POST | /studio/storyboard/boards/{board_id}/candidates/{cid}/adopt | 采纳候选 |
6. 前端
分镜表页面新增「故事板」页签:
- 选择格数、风格、附加要求;
- 主图预览 + 候选缩略图;
- 「再抽一张」「采纳这张」;
- 可展开查看本次提示词;
- 历史故事板列表。
7. 当前限制
- 图片模型对“正好 N 格、每格内容准确”的控制有限,必须人工审核;
- 角色一致性靠参考图 + 文字约束,不保证每格完全一致;
- 不支持单格重抽与 AI 助手修改(计划中);
- 故事板生成会计费,默认手动触发。