Multi-image fusion

Multi-image fusion combines elements from several reference images and a text prompt into a new image. doubao-seedream-5-0-260128 accepts 2–14 reference images. doubao-seedream-5-0-pro-260628 accepts 2–10.

What it does

• doubao-seedream-5-0-260128 accepts 2–14 reference images at once. doubao-seedream-5-0-pro-260628 accepts 2–10.
• It blends elements and styles from those images.
• doubao-seedream-5-0-260128 can return one image or a set. The pro model cannot return a set.

Request parameters

Parameter	Description	Required	Type
model	doubao-seedream-5-0-260128 or doubao-seedream-5-0-pro-260628	Yes	String
prompt	How to combine the images	Yes	String
image	Reference image array, URL or Base64	Yes	Array
sequential_image_generation	Whether to return a set: auto or disabled (doubao-seedream-5-0-260128 only)	No	String
size	Resolution	No	String
response_format	Response format	No	String
watermark	Whether to add a watermark	No	Boolean

Image requirements

Requirement	Details
Count	2–14 for doubao-seedream-5-0-260128, 2–10 for doubao-seedream-5-0-pro-260628
Format	jpeg, png, webp, bmp, tiff, gif, heic, heif
Size	Up to 30MB each
Aspect ratio	[1/16, 16]
Width and height	Greater than 14px
Total pixels	At least 196 pixels, at most 6000×6000 px

Examples

Fuse into one image

curl -X POST https://api-ai.xiaoku.ai/doubao/api/v3/images/generations \
  -H "Authorization: Bearer XIAOKU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "Fuse these images into one surreal artwork",
    "image": [
      "https://example.com/mountain.jpg",
      "https://example.com/ocean.jpg",
      "https://example.com/forest.jpg"
    ],
    "sequential_image_generation": "disabled",
    "size": "2K",
    "watermark": false
  }'

Fuse into a set

Only doubao-seedream-5-0-260128 supports a set:

curl -X POST https://api-ai.xiaoku.ai/doubao/api/v3/images/generations \
  -H "Authorization: Bearer XIAOKU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "Blend the style of these buildings into a future city from several angles",
    "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
  }'

Mix styles

curl -X POST https://api-ai.xiaoku.ai/doubao/api/v3/images/generations \
  -H "Authorization: Bearer XIAOKU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "Blend oil-painting style with photography into one look",
    "image": [
      "https://example.com/oil-painting.jpg",
      "https://example.com/photography.jpg"
    ],
    "size": "2K",
    "watermark": false
  }'

Response

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

Notes

1. doubao-seedream-5-0-260128 accepts 2–14 reference images. doubao-seedream-5-0-pro-260628 accepts 2–10.
2. doubao-seedream-5-0-pro-260628 cannot return a set. Use doubao-seedream-5-0-260128 for set fusion.
3. With sequential generation on doubao-seedream-5-0-260128, reference count + generated count ≤ 15
4. Give each reference a distinct subject for a better blend
5. Image URLs expire after 24 hours. Save them promptly.