Generations（Seedream 4.0）

POST

/doubao/images/generations

YouDream Latest Model Supporting Text-to-Image and Image-to-Image

Model Name:
doubao-seedream-4-0-250828

Features:

Generate Image Sets (set: based on your input, generate a group of content-related images; requires sequential_image_generation=auto)

Multi-image to Set: Based on your input of multiple reference images (2–10) + text prompts, generate a group of related images (number of reference images + generated images ≤ 15).

Single-image to Set: Based on your input of a single reference image + text prompt, generate a group of related images (up to 14 generated images).

Text-to-Set: Based on your text prompt, generate a group of related images (up to 15 generated images).

Generate Single Image (set sequential_image_generation=disabled)

Multi-image to Single: Based on your input of multiple reference images (2–10) + text prompt, generate a single image.

Single-image to Single: Based on your input of a single reference image + text prompt, generate a single image.

Text-to-Single: Based on your text prompt, generate a single image.

Price: 0.03 PTC / image

Recommended Aspect Ratios and Resolutions:

Resolution	Aspect Ratio	Pixel Size
1K	1:1	1024 × 1024
2K	1:1	2048 × 2048
	4:3	2304 × 1728
	3:2	2496 × 1664
	16:9	2560 × 1440
	21:9	3024 × 1296
4K	1:1	4096 × 4096
	4:3	4694 × 3520
	3:2	4992 × 3328
	16:9	5404 × 3040
	21:9	6198 × 2656

Request

Header Params

Body Params application/json

Examples

图生图文生图

{
    "model": "doubao-seedream-4-0-250828",
    "prompt": "生成3张女孩和奶牛玩偶在游乐园开心地坐过山车的图片，涵盖早晨、中午、晚上",
    "image": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_1.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_2.png"
    ],
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": {
        "max_images": 3
    },
    "response_format": "url",
    "size": "2K",
    "stream": false,
    "watermark": false
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

图生图文生图

curl --location 'https://api.302.ai/doubao/images/generations' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedream-4-0-250828",
    "prompt": "生成3张女孩和奶牛玩偶在游乐园开心地坐过山车的图片，涵盖早晨、中午、晚上",
    "image": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_1.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_2.png"
    ],
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": {
        "max_images": 3
    },
    "response_format": "url",
    "size": "2K",
    "stream": false,
    "watermark": false
}'

Responses

🟢200成功

application/json

Response Parameter Description

Field List

Field Name	Type	Description
model	string	The model ID used for this request (model name-version).
created	integer	The Unix timestamp (seconds) when this request was created.
data	list	Information about the output images, including the image download URL or Base64. - When the return format is specified as url, the field is `url` - When the return format is specified as b64_json, the field is `b64_json` Note: To ensure information security, the url link will expire within 24 hours after generation. Please make sure to save the image in time.
usage	object	Information related to image generation. - `usage.generated_images` (integer): Number of images generated by the model.
error	object	Error information (optional). - `error.code` (string): Error code - `error.message` (string): Error message

data Field Description

When response_format is url, each element in the data array contains the field:

url: Image download address

When response_format is b64_json, each element in the data array contains the field:

b64_json: Base64 encoded string of the image

usage Field Description

usage.generated_images: Number of images generated by the model (integer)

error Field Description (Optional)

error.code: Error code (string)

error.message: Error message (string)

Bodyapplication/json

Example

{
    "model": "doubao-seedream-4-0-250828",
    "created": 1757321139,
    "data": [
        {
            "url": "https://...",
            "size": "3104x1312"
        }
    ],
    "usage": {
        "generated_images": 1,
        "output_tokens": xxx,
        "total_tokens": xxx
    }
}

Modified at 2025-10-09 08:19:40

Generations（Seedream 4.5）

Generations（Seedream 3.0）