返回 VideoClaw
generate_image_it2i.md
根目录 / video-claw / references / sandbox / generate_image_it2i.md
1 # 图生图 (I2I)
2
3 使用图片生成图片(风格转换)。
4
5 ## 请求
6
7 ```bash
8 curl -X POST "http://localhost:8000/api/sandbox/i2i" \
9 -H "Content-Type: application/json" \
10 -d '{
11 "model": "doubao-seedream-5-0",
12 "prompt": "转换为动漫风格",
13 "image": "code/result/image/user_upload/photo.png"
14 }'
15 ```
16
17 ## 参数说明
18
19 | 参数 | 必填 | 说明 |
20 |------|------|------|
21 | model | | 模型,默认 doubao-seedream-5-0 |
22 | prompt | ✅ | 目标风格描述 |
23 | image | ✅ | 源图片路径 |
24
25 ## 可用模型
26
27 | 模型 | 说明 |
28 |------|------|
29 | doubao-seedream-5-0 | 默认 |
30 | wan2.6-image | |
31
32 ## ⚠️ 路径格式
33
34 - `image` 必须使用 `code/result/...` 格式的**相对路径**
35 - 禁止使用完整 URL 或本地路径
36
37 ## 响应
38
39 ```json
40 {
41 "success": true,
42 "image_url": "code/result/sandbox/images/xxx.png"
43 }
44 ```
45
46 ## 常见问题
47
48 | 错误 | 原因 | 解决方法 |
49 |------|------|----------|
50 | `curl: (7) Failed to connect` | 后端未运行 | 启动后端服务 |
51 | `"error": "image not found"` | 图片路径错误 | 确认 image 路径格式为 `code/result/...` |
52 | `"success": false` | API Key 额度用完或无效 | 检查对应平台的 API Key |
53 | 风格转换效果差 | 提示词不明确 | 使用更具体的风格描述 |
53 lines MARKDOWN