组图生成 ​

组图生成是指根据输入内容生成一组内容关联的图片的能力。该功能仅 doubao-seedream-5-0-260128 模型支持，doubao-seedream-5-0-pro-260628 暂不支持组图生成。

功能特点 ​

生成模式说明最大图片数量
文生组图根据文本提示词生成一组关联图片15张
单图生组图根据单张参考图+文本生成一组关联图片14张
多图生组图根据多张参考图(2-14张)+文本生成一组关联图片参考图数量+生成数量≤15

请求参数 ​

参数名称参数解释必填参数类型
model模型名称，值为 doubao-seedream-5-0-260128是String
prompt文本描述是String
image参考图片（可选），支持 URL 或 Base64否String/Array
sequential_image_generation组图模式，值为 auto是String
sequential_image_generation_options组图配置否Object
size图片分辨率否String
response_format返回格式否String
watermark是否添加水印否Boolean

sequential_image_generation_options ​

参数说明默认值
max_images最多生成图片数量，范围 [1, 15]15

使用示例 ​

文生组图 ​

根据文本提示词自动生成一组关联图片：

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": "不同风格的城市夜景，包括现代都市、古镇、海边城市",
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": {
      "max_images": 5
    },
    "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-260128",
    "prompt": "以这张图片为灵感，生成不同季节的风景",
    "image": "https://example.com/landscape.jpg",
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": {
      "max_images": 4
    },
    "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-260128",
    "prompt": "融合这些图片的元素，生成一组创意图片",
    "image": [
      "https://example.com/image1.jpg",
      "https://example.com/image2.jpg",
      "https://example.com/image3.jpg"
    ],
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": {
      "max_images": 12
    },
    "watermark": false
  }'

返回示例 ​

json
{
    "model": "doubao-seedream-5-0-260128",
    "created": 1757321139,
    "data": [
        { "url": "https://api-ai.xku.com/images/image1.jpg" },
        { "url": "https://api-ai.xku.com/images/image2.jpg" },
        { "url": "https://api-ai.xku.com/images/image3.jpg" },
        { "url": "https://api-ai.xku.com/images/image4.jpg" },
        { "url": "https://api-ai.xku.com/images/image5.jpg" }
    ],
    "usage": {
        "generated_images": 5
    }
}

注意事项 ​

  1. 组图功能仅 doubao-seedream-5-0-260128 模型支持，doubao-seedream-5-0-pro-260628 不支持
  2. 参考图片数量 + 生成图片数量 ≤ 15
  3. 多图输入时，最多支持 14 张参考图片
  4. 生成的图片链接 24 小时内有效，请及时保存