You need to enable JavaScript to run this app.
Lake AI Service

Lake AI Service

Copy page
Download PDF
Image generation
Image generation (Seedream series models)
Copy page
Download PDF
Image generation (Seedream series models)

Operator introduction

Description

The Seedream image generation model can generate high-quality images based on user input text or reference images, supporting multi-image grouping and streaming output.

Function overview

  • The Doubao Seedream series image creation model supports text, single-image, and multi-image input, enabling multi-image fusion creation based on subject consistency, image editing, multi-image generation, and other diverse features, making image creation more flexible and controllable. The newly released doubao-seedream-5.0-lite model offers enhanced generation quality in consistency, instruction adherence, text rendering, knowledge richness, and professional scenarios, better meeting enterprise-level visual creation needs. The model advantages are as follows:
    • Strong timeliness: doubao-seedream-5.0-lite is equipped with internet search functionality for the first time. The model autonomously determines whether to search internet content based on user prompts, integrates real-time online information, and improves the timeliness of image generation.
    • Strong instruction adherence: The alignment between generated images and input text is improved, reducing the illusion of “text-image mismatch” and accurately responding to detailed text instructions.
    • Strong consistency: Maintains a high degree of uniformity in character features, style, and details across images, ensuring completely stable and reliable generation results.
  • LAS has integrated doubao-seedream-5.0-lite, doubao-seedream-4.5, doubao-seedream-4.0, and doubao-seedream-3.0-t2i models.

Application scenarios

The Seedream series models can be widely applied in e-commerce, gaming, film and television, animation, and design industries, profoundly transforming traditional content production methods and significantly improving the efficiency of visual content production.

  • E-commerce materials: virtual try-on, product real scene images, product selling point images, secondary editing of product images, and related scenarios.
  • Film and television creation: character design, scene design, storyboard generation, and converting sketches to final artwork.
  • Advertising and marketing: marketing posters, cover design, event banners, and related scenarios.
  • Entertainment features: portrait photography, creative group shots, face swapping, style transfer, emoji creation, and related scenarios.
  • Education and office: knowledge illustrations, graphic posters, popular science infographics, chart generation, and related scenarios.
  • Game design: character design, scene design, prop design, UI design, and related scenarios.

Limitations

  • doubao-seedThe ream-5.0-lite model supports 2K and 3K resolution output.
  • doubao-seedWithin the ream series, only the 4.0, 4.5, and 5.0-lite models support generating image sets. The number of input reference images plus the number of final generated images must not exceed 15.
  • doubao-seedWithin the ream series, only the 4.0, 4.5, and 5.0-lite models support streaming output.
  • doubao-seedThe ream-3.0-t2i model supports only text-to-image generation.

Caution and prerequisites

Details

Caution and prerequisites

Costs

Before calling an operator, you need to understand the model invocation costs associated with using the operator. For details, see Large model invocation billing.

Authentication (API Key)

Before calling an operator, you need to generate an API Key for operator invocation. It is recommended to configure the API Key as an environment variable to ensure safer operator calls. For details, see Obtain and configure API Key.

BaseURL

Before calling an operator, you need to determine the BaseURL for operator invocation based on the region where your current LAS service is deployed. This is used to configure the path parameter values for operator calls.
For details, see Obtain the Base URL. The Examples below are for reference only; when making actual calls, replace the path values with those corresponding to your region.

API call

Image generation (non-streaming)

POST https://operator.las.ap-southeast-1.volces.com/api/v1/online/images/generations

API description

Invoke the Seedream image generation model to perform text-to-image, image-to-image, or image set generation (non-streaming).

Request parameters

Parameter name
Type
Required
Example
Description
model
string
Yes
doubao-seedream-4-5-251128
Model ID used in this request. Supported values: doubao-seedream-5-0-lite-260128, doubao-seedream-5-0-260128, doubao-seedream-4-5-251128, doubao-seedream-4-0-250828, doubao-seedream-3-0-t2i-250415.
prompt
string
Yes
An orange cat wearing sunglasses, sitting by the sea at sunset, ultra-realistic.
Prompt used to generate the image. Supports both Chinese and English. Recommended length: no more than 300 Chinese characters or 600 English words.
tools
array of tools_item
No
Supported only by doubao-seedream-5.0-lite (doubao-seedream-5-0-lite-260128 / doubao-seedream-5-0-260128). Used to configure tools for the model.
  • After web search is enabled, the model can decide whether to search internet content such as products or weather based on the prompt, improving the timeliness of generated images, though it may add latency.
  • The actual number of searches can be checked via usage.tool_usage.web_search. A value of 0 means no search was performed.
image
string / array
No
Input image information. Supports URL or Base64 encoding.
  • doubao-seedream-3.0-t2i does not support this parameter.
  • doubao-seedream-5.0-lite/4.5/4.0 support single-image or multi-image input.
  • Base64 format: data:image/<image format>;base64,<Base64> where <image format> must be lowercase.
  • Image limits: formats jpeg, png (doubao-seedream-5.0-lite/4.5/4.0 additionally support webp, bmp, tiff, and gif); aspect-ratio range for doubao-seedream-5.0-lite/4.5/4.0 is [1/16, 16]; width and height must both be greater than 14px; size must not exceed 10MB; total pixels must not exceed 6000x6000; doubao-seedream-5.0-lite/4.5/4.0 support up to 14 reference images.
size
string
No
2048x2048
Specifies the output image size.
  • doubao-seedream-5.0-lite: supports 2K, 3K, or explicit width and height; default 2048x2048; total pixel range [2560x1440, 3072x3072x1.1025]; aspect-ratio range [1/16, 16].
  • doubao-seedream-4.5: supports 2K, 4K, or explicit width and height; default 2048x2048; total pixel range [2560x1440, 4096x4096]; aspect-ratio range [1/16, 16].
  • doubao-seedream-4.0: supports 1K, 2K, 4K, or explicit width and height; default 2048x2048; total pixel range [1280x720, 4096x4096]; aspect-ratio range [1/16, 16].
  • doubao-seedream-3.0-t2i: supports only explicit width and height; default 1024x1024; single-image pixel range [512x512, 2048x2048].
seed
integer
No
-1
Supported only by doubao-seedream-3.0-t2i. Random seed. Valid range: [-1, 2147483647].
sequential_image_generation
string
No
disabled
Supported only by doubao-seedream-5.0-lite/4.5/4.0. auto means the model decides whether to return an image set; disabled means only one image is generated.
sequential_image_generation_options
sequential_image_generation_options
No
Supported only by doubao-seedream-5.0-lite/4.5/4.0. Effective only when sequential_image_generation=auto.
guidance_scale
float
No
2.5
Not supported by doubao-seedream-5.0-lite/4.5/4.0; default value for doubao-seedream-3.0-t2i is 2.5. Valid range: [1, 10].
response_format
string
No
url
Specifies the return format of the generated image. Supported values:
url: returns an image download link. The link is valid for 24 hours after generation, so please download the image in time.
b64_json: returns the image data as a Base64-encoded JSON string.
output_format
string
No
jpeg
Supported only by doubao-seedream-5.0-lite (doubao-seedream-5-0-lite-260128 / doubao-seedream-5-0-260128). Specifies the output file format of the generated image. Supported values: png, jpeg; default is jpeg.
Note: images generated by doubao-seedream-4.5/4.0 and doubao-seedream-3.0-t2i/seededit-3.0-i2i are always in jpeg format and do not support custom configuration.
watermark
boolean
No
true
Whether to add an “AI-generated” watermark. false means no watermark; true means watermark added.
optimize_prompt_options
optimize_prompt_options
No
Supported only by doubao-seedream-5.0-lite/4.5 (currently standard mode only) and doubao-seedream-4.0.

Response parameters

Parameter name
Type
Example
Description
model
string
doubao-seedream-4-5-251128
Model ID used in this request (model-name-version).
created
integer
1589478378
Unix timestamp (seconds) when the request was created.
data
list of data_item
List of generated image outputs.
tools
list of tools_item
Tool configuration used in this request (returned only when tools is configured).
usage
usage
Usage information for this request.
error
error_info
Request-level error information.

Example

Request example

curl --location "https://operator.las.ap-southeast-1.volces.com/api/v1/images/generations" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $LAS_API_KEY" \
--data '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "",
    "size": "2048x2048",
    "response_format": "url",
    "watermark": true
}'

Response example

{
    "model": "doubao-seedream-4-5-251128",
    "created": 1764041608,
    "data": [
        {
            "url": "<image_url>",
            "size": "2048x2048"
        }
    ],
    "usage": {
        "generated_images": 1,
        "output_tokens": 16384,
        "total_tokens": 16384
    }
}

Image generation (streaming)

POST https://operator.las.ap-southeast-1.volces.com/api/v1/online/images/generations

API description

Invoke the Seedream image generation model to perform text-to-image, image-to-image, or image set generation (streaming SSE).

Request parameters

Parameter name
Type
Required
Example
Description
model
string
Yes
doubao-seedream-4-5-251128
Model ID used in this request. Supported values: doubao-seedream-5-0-lite-260128, doubao-seedream-5-0-260128, doubao-seedream-4-5-251128, doubao-seedream-4-0-250828, doubao-seedream-3-0-t2i-250415.
prompt
string
Yes
An orange cat wearing sunglasses, sitting by the sea at sunset, ultra-realistic.
Prompt used to generate the image. Supports both Chinese and English. Recommended length: no more than 300 Chinese characters or 600 English words.
tools
array of tools_item
No
Supported only by doubao-seedream-5.0-lite (doubao-seedream-5-0-lite-260128 / doubao-seedream-5-0-260128). Used to configure tools for the model.
  • After web search is enabled, the model can decide whether to search internet content such as products or weather based on the prompt, improving the timeliness of generated images, though it may add latency.
  • The actual number of searches can be checked via usage.tool_usage.web_search. A value of 0 means no search was performed.
image
string / array
No
Input image information. Supports URL or Base64 encoding.
  • doubao-seedream-3.0-t2i does not support this parameter.
  • doubao-seedream-5.0-lite/4.5/4.0 support single-image or multi-image input.
  • Base64 format: data:image/<image format>;base64,<Base64> where <image format> must be lowercase.
  • Image limits: formats jpeg, png (doubao-seedream-5.0-lite/4.5/4.0 additionally support webp, bmp, tiff, and gif); aspect-ratio range for doubao-seedream-5.0-lite/4.5/4.0 is [1/16, 16]; width and height must both be greater than 14px; size must not exceed 10MB; total pixels must not exceed 6000x6000; doubao-seedream-5.0-lite/4.5/4.0 support up to 14 reference images.
size
string
No
2048x2048
Specifies the output image size.
  • doubao-seedream-5.0-lite: supports 2K, 3K, or explicit width and height; default 2048x2048; total pixel range [2560x1440, 3072x3072x1.1025]; aspect-ratio range [1/16, 16].
  • doubao-seedream-4.5: supports 2K, 4K, or explicit width and height; default 2048x2048; total pixel range [2560x1440, 4096x4096]; aspect-ratio range [1/16, 16].
  • doubao-seedream-4.0: supports 1K, 2K, 4K, or explicit width and height; default 2048x2048; total pixel range [1280x720, 4096x4096]; aspect-ratio range [1/16, 16].
  • doubao-seedream-3.0-t2i: supports only explicit width and height; default 1024x1024; single-image pixel range [512x512, 2048x2048].
seed
integer
No
-1
Supported only by doubao-seedream-3.0-t2i. Random seed. Valid range: [-1, 2147483647].
sequential_image_generation
string
No
disabled
Supported only by doubao-seedream-5.0-lite/4.5/4.0. auto means the model decides whether to return an image set; disabled means only one image is generated.
sequential_image_generation_options
sequential_image_generation_options
No
Supported only by doubao-seedream-5.0-lite/4.5/4.0. Effective only when sequential_image_generation=auto.
stream
boolean
Yes
true
Supported only by doubao-seedream-5.0-lite/4.5/4.0. Must be set to true to enable streaming output (SSE).
guidance_scale
float
No
2.5
Not supported by doubao-seedream-5.0-lite/4.5/4.0; default value for doubao-seedream-3.0-t2i is 2.5. Valid range: [1, 10].
response_format
string
No
url
Specifies the return format of the generated image. Supported values:
url: returns an image download link. The link is valid for 24 hours after generation, so please download the image in time.
b64_json: returns the image data as a Base64-encoded JSON string.
output_format
string
No
jpeg
Supported only by doubao-seedream-5.0-lite (doubao-seedream-5-0-lite-260128 / doubao-seedream-5-0-260128). Specifies the output file format of the generated image. Supported values: png, jpeg; default is jpeg.
Note: images generated by doubao-seedream-4.5/4.0 and doubao-seedream-3.0-t2i/seededit-3.0-i2i are always in jpeg format and do not support custom configuration.
watermark
boolean
No
true
Whether to add an “AI-generated” watermark. false means no watermark; true means watermark added.
optimize_prompt_options
optimize_prompt_options
No
Supported only by doubao-seedream-5.0-lite/4.5 (currently standard mode only) and doubao-seedream-4.0.

Response parameters

Parameter name
Type
Example
Description
type
string
image_generation.partial_succeeded
Event type. Possible values: image_generation.partial_succeeded, image_generation.partial_failed, image_generation.completed, error.
model
string
doubao-seedream-4-0-250828
Model ID used in this request, in the format <model-name>-<version>.
created
integer
1589478378
Unix timestamp (seconds) when the request was created.
image_index
integer
0
Index of the image corresponding to this event within the request. It starts from 0 and increases automatically regardless of whether image generation succeeds.
url
string
https://...
Download URL of the image corresponding to this event. Returned when response_format=url.
b64_json
string
<base64>
Base64-encoded image data corresponding to this event. Returned when response_format=b64_json.
size
string
2048x2048
Width and height of the image in pixels, formatted as <width>x<height>, such as 2048x2048.
tools
list of tools_item
Tool configuration used in this request (returned only when tools is configured). Returned only when the event type is image_generation.completed.
usage
usage
Usage information for this request. Returned only when the event type is image_generation.completed.

Example

Request example

curl --location "https://operator.las.ap-southeast-1.volces.com/api/v1/images/generations" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $LAS_API_KEY" \
--data '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "",
    "size": "2048x2048",
    "response_format": "url",
    "stream": true
}'

Response example

{
    "type": "image_generation.completed",
    "model": "doubao-seedream-4-5-251128",
    "created": 1589478378,
    "usage": {
        "generated_images": 1,
        "output_tokens": 16384,
        "total_tokens": 16384
    }
}

Error codes

HttpCode

Error code

Error message

Description

400

Model.InvalidName

The model name is invalid.

The model name is invalid.

401

Authorization.Missing

Missing Authorization.

Missing Authorization.

401

ApiKey.Invalid

The api key is invalid.

The API is invalid.

Last updated: 2026.05.24 15:22:13