图生图 ​

图生图是指根据输入的参考图片和文本描述，生成新图像的能力。可以实现风格转换、内容修改、细节增强等效果。

支持的模型 ​

模型名称最大参考图数量特点
doubao-seedream-5-0-26012814张支持多图融合、组图生成
doubao-seedream-5-0-pro-26062810张支持多图融合、交互编辑、图层拆分，不支持组图生成

请求参数 ​

参数名称参数解释必填参数类型
model模型名称是String
prompt文本描述，说明希望如何修改图片是String
image参考图片，支持 URL 或 Base64 编码是String/Array
size图片分辨率否String
response_format返回格式，url 或 b64_json否String
watermark是否添加水印否Boolean

image 参数格式 ​

URL 格式：

json
{
  "image": "https://example.com/reference.jpg"
}

Base64 格式：

json
{
  "image": "data:image/png;base64,iVBORw0KGgo..."
}

多图输入（doubao-seedream-5-0-260128 最多支持 14 张，doubao-seedream-5-0-pro-260628 最多支持 10 张）：

json
{
  "image": [
    "https://example.com/image1.jpg",
    "https://example.com/image2.jpg"
  ]
}

图片要求 ​

要求说明
格式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/photo.jpg",
    "size": "2K",
    "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/portrait.jpg",
    "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/scene.jpg",
    "watermark": false
  }'

返回示例 ​

json
{
    "model": "doubao-seedream-5-0-pro-260628",
    "created": 1757321139,
    "data": [
        {
            "url": "https://api-ai.xku.com/images/xxx.jpg"
        }
    ],
    "usage": {
        "generated_images": 1
    }
}

注意事项 ​

  1. 参考图片需要确保可公开访问（URL 方式）
  2. doubao-seedream-5-0-260128 支持最多 14 张参考图片的多图融合，doubao-seedream-5-0-pro-260628 支持最多 10 张
  3. doubao-seedream-5-0-pro-260628 不支持组图生成，组图功能请使用 doubao-seedream-5-0-260128
  4. 生成的图片链接 24 小时内有效，请及时保存