返回 VideoClaw
modify_character.md
根目录 / video-claw / references / workflow / modify_character.md
1 # 修改角色/场景提示词
2
3 在第二阶段完成后,用户可以修改角色或场景的视觉提示词并重新生成。
4
5 ## 修改角色提示词
6
7 ```bash
8 curl -X PATCH "http://localhost:8000/api/project/{session_id}/artifact/character_design" \
9 -H "Content-Type: application/json" \
10 -d '{
11 "characters": [
12 {
13 "id": "char_1",
14 "visual_prompt": "新的视觉提示词"
15 }
16 ]
17 }'
18 ```
19
20 ## 重新执行角色/场景设计
21
22 ```bash
23 curl -X POST "http://localhost:8000/api/project/{session_id}/execute/character_design" \
24 -H "Content-Type: application/json" \
25 -d '{"session_id": "xxx"}'
26 ```
27
28 ## 参数说明
29
30 | 参数 | 说明 |
31 |------|------|
32 | characters[].id | 角色 ID |
33 | characters[].visual_prompt | 新的视觉提示词 |
34
35 > 修改后需要重新执行阶段才能生效。
36
37 ## 常见问题
38
39 | 错误 | 原因 | 解决方法 |
40 |------|------|----------|
41 | `curl: (7) Failed to connect` | 后端未运行 | 启动后端服务 |
42 | `404 Not Found` | session_id 错误 | 确认 session_id 正确 |
43 | PATCH 成功但无变化 | 需要重新执行阶段 | 调用 execute/character_design 重新生成 |
44 | 角色 ID 不存在 | ID 错误 | 从 artifact 中获取正确的角色 ID |
44 lines MARKDOWN