Skip to content
可视化故事板(16:9 多格)

可视化故事板(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:

  1. 读取 shot_plan_candidates,忽略 review_status=ignored;
  2. 按 order_index 取前 N 行;
  3. 每行提取标题、景别、角度、运镜、场景、角色、服装、动作、台词摘要、情绪;
  4. 生成 16:9 多格提示词:交付物 → 镜头内容 → 风格 → 标注 → 约束;
  5. 参考图优先取主要角色的当前设定板,其次角色正面图,最多 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 助手修改(计划中);
  • 故事板生成会计费,默认手动触发。