EED-141 · SKILL-002添加§5图生图·角色一致性 · API支持参考图参数

bingshuo-heartbeat/skills/SKILL-002-API调用手册.hdlp

@@ -120,3 +120,76 @@ curl -s "https://dashscope.aliyuncs.com/api/v1/tasks/{TASK_ID}" \
 
 > 本技能包由蛋蛋整理 · 闭着眼睛都能调用
 > 下次做短剧直接加载 · 不需要再查API文档
+
+---
+
+## §5 图生图·角色一致性（2026-07-15调研）
+
+### 5.1 参考图参数
+```bash
+# 文生图+参考图（保持角色/风格一致）
+curl -s "https://ark.cn-beijing.volces.com/api/v3/images/generations" \
+  -H "Authorization: Bearer ${VOLCENGINE_API_KEY}" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "doubao-seedream-4-0-250828",
+    "prompt": "参考图中的人物形象，在修仙世界广场上...",
+    "image": ["https://角色参考图URL.png"],
+    "size": "1024x1024"
+  }'
+```
+
+### 5.2 参数说明
+```
+image: 参考图URL数组（最多10张）
+  - 单角色：传1张角色审批图
+  - 多角色：传多张（最多10张）
+  - 风格参考：传风格图
+
+prompt: 必须描述"参考图中的XXX"
+  - "参考图中的人物形象，在..."
+  - "参考图中的风格，设计..."
+```
+
+### 5.3 组图生成（批量关联图）
+```bash
+curl -s "https://ark.cn-beijing.volces.com/api/v3/images/generations" \
+  -H "Authorization: Bearer ${VOLCENGINE_API_KEY}" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "doubao-seedream-4-0-250828",
+    "prompt": "Generate 3 images of a girl in different scenes...",
+    "image": ["https://角色图.png"],
+    "sequential_image_generation": "auto",
+    "sequential_image_generation_options": {"max_images": 3},
+    "size": "1024x1024"
+  }'
+```
+
+### 5.4 苏白短剧应用
+```
+角色参考图位置（老仓库）:
+  苏白: guanghulab/video-ai-system/assets/approved/CHAR-003-SuBai/CHAR-003-V3-R4-approved-1440x2560.png
+  诸葛风: guanghulab/video-ai-system/assets/approved/CHAR-004-ZhugeFeng/CHAR-004-V2-approved-1440x2560.png
+  王执事: guanghulab/video-ai-system/assets/approved/CHAR-005-WangZhiShi/CHAR-005-V1-R2-approved-1440x2560.png
+  中年男子: guanghulab/video-ai-system/assets/approved/CHAR-006-ZhongNian/CHAR-006-V1-approved-1440x2560.png
+  欧阳员外: guanghulab/video-ai-system/assets/approved/CHAR-007-Ouyang/CHAR-007-V1-approved-1440x2560.png
+
+工作流:
+  1. 读分镜 → 确定这镜需要哪个角色
+  2. 调API → image参数传对应角色图
+  3. 生成 → 角色一致性大幅提升
+```
+
+### 5.5 注意事项
+```
+️ 参考图必须是可访问的URL（不能是本地路径）
+⚠️ 每次生图都要传参考图（没有"缓存"功能）
+⚠️ 参考图会额外消耗token（约0.00x元/张）
+️ 最多10张参考图，太多影响一致性
+```
+
+---
+
+> 调研完成 · 2026-07-15 · D186
+> 关键发现：API支持参考图 → 角色一致性有解了！