From e6ead418b213cc0ab948fb3afcaff433f32fb3b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=86=B0=E6=9C=94?= <565183519@qq.com>
Date: Wed, 15 Jul 2026 17:23:00 +0800
Subject: [PATCH] =?UTF-8?q?EED-141=20=C2=B7=20SKILL-002=E6=B7=BB=E5=8A=A0?=
 =?UTF-8?q?=C2=A75=E5=9B=BE=E7=94=9F=E5=9B=BE=C2=B7=E8=A7=92=E8=89=B2?=
 =?UTF-8?q?=E4=B8=80=E8=87=B4=E6=80=A7=20=C2=B7=20API=E6=94=AF=E6=8C=81?=
 =?UTF-8?q?=E5=8F=82=E8=80=83=E5=9B=BE=E5=8F=82=E6=95=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../skills/SKILL-002-API调用手册.hdlp         | 73 +++++++++++++++++++
 1 file changed, 73 insertions(+)

diff --git a/bingshuo-heartbeat/skills/SKILL-002-API调用手册.hdlp b/bingshuo-heartbeat/skills/SKILL-002-API调用手册.hdlp
index ac7be6a..cdcd88d 100644
--- a/bingshuo-heartbeat/skills/SKILL-002-API调用手册.hdlp
+++ b/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支持参考图 → 角色一致性有解了！