多图融合
多图融合是指根据多张参考图片和文本描述,融合多个图片的元素生成新图像的能力。doubao-seedream-5-0-260128 支持 2-14 张参考图片,doubao-seedream-5-0-pro-260628 支持 2-10 张参考图片。
功能特点
- doubao-seedream-5-0-260128 支持同时传入 2-14 张参考图片,doubao-seedream-5-0-pro-260628 支持 2-10 张
- 智能融合多张图片的元素和风格
- doubao-seedream-5-0-260128 可以生成单图或组图(pro 不支持组图生成)
请求参数
| 参数名称 | 参数解释 | 必填 | 参数类型 |
|---|---|---|---|
| model | 模型名称,可选 doubao-seedream-5-0-260128、doubao-seedream-5-0-pro-260628 | 是 | String |
| prompt | 文本描述,说明如何融合图片 | 是 | String |
| image | 参考图片数组,支持 URL 或 Base64 | 是 | Array |
| sequential_image_generation | 是否生成组图,auto 或 disabled(仅 doubao-seedream-5-0-260128 支持) | 否 | String |
| size | 图片分辨率 | 否 | String |
| response_format | 返回格式 | 否 | String |
| watermark | 是否添加水印 | 否 | Boolean |
图片要求
| 要求 | 说明 |
|---|---|
| 数量 | doubao-seedream-5-0-260128 支持 2-14 张,doubao-seedream-5-0-pro-260628 支持 2-10 张 |
| 格式 | jpeg、png、webp、bmp、tiff、gif、heic、heif |
| 大小 | 不超过 30MB/张 |
| 宽高比 | [1/16, 16] |
| 宽高长度 | 大于 14px |
| 总像素 | 不低于 196 像素,不超过 6000×6000 px |
使用示例
多图融合生成单图
融合多张图片的元素生成一张新图片:
bash
curl -X POST https://api-ai.xku.com/doubao/api/v3/images/generations \
-H "Authorization: Bearer XKU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedream-5-0-pro-260628",
"prompt": "将这些图片融合在一起,创造一幅超现实的艺术作品",
"image": [
"https://example.com/mountain.jpg",
"https://example.com/ocean.jpg",
"https://example.com/forest.jpg"
],
"sequential_image_generation": "disabled",
"size": "2K",
"watermark": false
}'多图融合生成组图
融合多张图片的元素生成一组图片(仅 doubao-seedream-5-0-260128 支持):
bash
curl -X POST https://api-ai.xku.com/doubao/api/v3/images/generations \
-H "Authorization: Bearer XKU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedream-5-0-260128",
"prompt": "融合这些建筑图片的风格,生成不同视角的未来城市",
"image": [
"https://example.com/building1.jpg",
"https://example.com/building2.jpg",
"https://example.com/building3.jpg",
"https://example.com/building4.jpg"
],
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
"max_images": 10
},
"watermark": false
}'风格混合
将不同风格的图片融合:
bash
curl -X POST https://api-ai.xku.com/doubao/api/v3/images/generations \
-H "Authorization: Bearer XKU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedream-5-0-pro-260628",
"prompt": "将油画风格和摄影风格融合,创造独特的视觉效果",
"image": [
"https://example.com/oil-painting.jpg",
"https://example.com/photography.jpg"
],
"size": "2K",
"watermark": false
}'返回示例
json
{
"model": "doubao-seedream-5-0-pro-260628",
"created": 1757321139,
"data": [
{ "url": "https://api-ai.xku.com/images/fused-image.jpg" }
],
"usage": {
"generated_images": 1
}
}注意事项
- doubao-seedream-5-0-260128 支持 2-14 张参考图片,doubao-seedream-5-0-pro-260628 支持 2-10 张
- doubao-seedream-5-0-pro-260628 不支持组图生成;组图融合请使用 doubao-seedream-5-0-260128
- 使用 doubao-seedream-5-0-260128 启用组图生成时,参考图片数量 + 生成数量 ≤ 15
- 建议每张图片的主题有所差异,以便获得更好的融合效果
- 生成的图片链接 24 小时内有效,请及时保存