create_storyboard.md - VideoClaw

create_storyboard.md

1	# 生成分镜
2
3	执行第三阶段：分镜设计。
4
5	---
6
7	## 请求
8
9	```bash
10	curl -X POST "http://localhost:8000/api/project/{session_id}/execute/storyboard" \
11	-H "Content-Type: application/json" \
12	-d '{"session_id": "xxx"}'
13	```
14
15	---
16
17	## 停点说明
18
19	此阶段有 1 个停点：分镜设计完成后需要用户确认。
20
21	## 产物结构
22
23	```json
24	{
25	"episodes": [
26	{
27	"episode_number": 1,
28	"segments": [
29	{
30	"segment_id": "1-1",
31	"scene_name": "场景名",
32	"characters": ["角色A"],
33	"plot": "分镜描述",
34	"visual_prompt": "视觉提示词",
35	"duration": 5,
36	"setting_id": "set_xxx"
37	}
38	]
39	}
40	]
41	}
42	```
43
44	## 停点4：分镜设计完成，等待用户确认后继续下一阶段
45
46	必须向用户发送消息，展示完整的分镜列表：
47
48	按剧集和分镜顺序展示：
49
50	\| 剧集 \| 分镜ID \| 时长 \| 人物 \| 地点 \| 情节描述 \|
51	\|------\|--------\|------\|------\|------\|----------\|
52	\| 第1集 \| 1-1 \| 5s \| 角色A \| 咖啡馆 \| 两人在咖啡馆交谈 \|
53
54	发送消息时必须：
55	- 使用文字形式发送表格（参考 [send_message/feishu.md](../send_message/feishu.md)）
56	- 包含按剧集统计的时长
57	- 发送前端 URL（获取本地 IPv4 地址，构造 `http://{local_ip}:3000/?session={session_id}&stage=storyboard`）
58	- 发送完整列表后，询问用户确认
59
60	询问内容示例：
61	> "分镜设计已完成，共生成 X 集，总时长约 Y 秒。请确认是否继续生成参考图？"
62
63	## 继续下一阶段
64
65	用户确认后调用：
66
67	```bash
68	curl -X POST "http://localhost:8000/api/project/{session_id}/continue"
69	```
70
71	---
72
73	## 智能续写（可选）
74
75	用户可以要求续写分镜：
76
77	```bash
78	curl -X POST "http://localhost:8000/api/project/{session_id}/intervene" \
79	-H "Content-Type: application/json" \
80	-d '{"stage": "storyboard", "modifications": {"continue_story": true}}'
81	```
82
83	---
84
85	## 常见问题
86
87	\| 错误 \| 原因 \| 解决方法 \|
88	\|------\|------\|----------\|
89	\| `curl: (7) Failed to connect` \| 后端未运行 \| 启动后端服务 \|
90	\| 分镜数量太少 \| LLM 生成不完整 \| 询问用户是否需要续写 \|
91	\| 用户不确认 \| 用户想修改分镜 \| 调用 modify_storyboard 修改 \|
92	\| 续写失败 \| 剧本内容不足 \| 检查剧本阶段产物是否完整 \|
93

93 lines MARKDOWN