Generations（Seedream 4.5）

POST

/doubao/images/generations

The latest model from Doubao Seedream supports both text-generated and image-generated images.

Model Name: doubao-seedream-4-5-251128

Functions:

Generate image sets (Image sets: A group of related images generated based on your input; requires sequential_image_generation to be configured as auto)

Generate image sets from multiple images: Generates a group of related images based on multiple reference images (2-10) + text prompts you input (number of input reference images + final number of generated images ≤ 15).

Generate image sets from a single image: Generates a group of related images based on a single reference image + text prompts you input (maximum 14 images).

Generate image sets from text prompts you input (maximum 15 images).

Generate a single image (configure sequential_image_generation as disabled)

Generate a single image from multiple reference images: Generate a single image based on your input of multiple reference images (2-10) + text prompts.

Generate a single image from a single reference image: Generate a single image based on your input of a single reference image + text prompts.

Generate a single image from text prompts: Generate a single image based on your input of a text prompt.

Price: 0.04 PTC/image

Recommended available aspect ratios:

Resolution	Aspect Ratio	Resolution (px)
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

Image-to-ImageText-to-image

{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "Replace the clothing in Figure 1 with the clothing in Figure 2.",
    "image": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png"
    ],
    "sequential_image_generation": "disabled",
    "size": "2K",
    "watermark": false
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Image-to-ImageText-to-image

curl --location --request POST 'https://api.302.ai/doubao/images/generations' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "Replace the clothing in Figure 1 with the clothing in Figure 2.",
    "image": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png"
    ],
    "sequential_image_generation": "disabled",
    "size": "2K",
    "watermark": false
}'

Responses

🟢200success

application/json

Response Parameter Description

Field List

Field Name	Type	Description
model	string	The model ID used in this request (model name-version).
created	integer	The Unix timestamp (in seconds) at the time this request was created.
data	list	Information about the output images, including the URL or Base64 of the image download. - 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 be sure to save the images in time.
usage	object	Image generation related information. - `usage.generated_images` (integer): The number of images generated by the model.
error	object	Error message (optional). - `error.code` (string): Error code - `error.message` (string): Error message

data field description

When response_format is url, each element of the data array contains the following fields:

url: Image download address

When response_format is b64_json, each element of the data array contains the following fields:

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)

Body

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-12-03 12:00:34

Luma-Photon-Flash（Fast image generation）

Generations（Seedream 4.0）