ByteDance Seedream Images API
POSThttps://api.acedata.cloud/seedream/images
ByteDance Seedream image generation API allows you to input text to generate images.
Related Products
SeeDream - Ace Data Cloud
SeeDream image generation platform, directly interfaces with this API, high-speed and stable availability.
Request Headers
acceptstring
Specify the format of the response returned by the server. If not specified, the default format is `application/json`.
Please select
authorizationstring
Bearer token
Request Body
modelstringRequired parameter
Models used for generating images. If not specified, the default is `doubao-seedream-5.0-lite`.
promptstringRequired parameter
Prompts for generating images.
imagearray
Reference image links for image editing are required, supporting accessible http/https URLs, or base64 encoded image strings in the format `data:image/png;base64,iVBORw0KG...`. Each image must not exceed 10MB in size. This parameter is mandatory when using image-to-image models (such as `doubao-seededit-3.0-i2i`).
sizestring
The size or aspect ratio of the generated image. Supports preset options (`1K`/`2K`/`3K`/`4K`), `adaptive` (adaptive reference image size), or explicit `<width>x<height>` format (e.g., `1024x1024`). **Different models support different preset options**: `doubao-seedream-5.0-lite` supports `2K`/`3K`/`4K`; `doubao-seedream-4.5` only supports `2K`/`4K`; `doubao-seedream-4.0` supports `1K`/`2K`/`4K`; `doubao-seedream-3.0-t2i` and `doubao-seededit-3.0-i2i` **do not support** any preset options and must pass explicit `<width>x<height>` values.
seedinteger
Generate a random seed for image generation. The supported range is [-1, 2147483647], with a default value of `-1`. **Only `doubao-seedream-3.0-t2i` supports this parameter** (according to the official Volcengine documentation), other models do not accept this parameter.
sequential_image_generationstring
The default value is `disabled`. Setting it to `auto` allows the model to generate a set of stylistically coherent related images (multi-image consistency, sharing characters, styles, and details across frames). Only `doubao-seedream-5.0-lite`, `doubao-seedream-4.5`, and `doubao-seedream-4.0` are supported.
Please select
sequential_image_generation_optionsobject
Adjustable parameters for batch image generation. Effective only when `sequential_image_generation=auto`. Only supports `doubao-seedream-5.0-lite`, `doubao-seedream-4.5`, and `doubao-seedream-4.0`.
max_imagesinteger
The maximum number of images that can be generated in this request is in the range of [1, 15]. Note: `（the number of reference images in 'image'） + （the number of images generated this time）` must not exceed 15.
streamboolean
Whether to return all images in a streaming manner, default is `false`. Only supports `doubao-seedream-5.0-lite`, `doubao-seedream-4.5`, and `doubao-seedream-4.0`.
Please select
guidance_scalefloat
Prompt word weight, the larger the value, the more relevant the generated result is to the prompt word. Only supports `doubao-seedream-3.0-t2i` (default value 2.5) and `doubao-seededit-3.0-i2i` (default value 5.5), both ranges are [1, 10].
response_formatstring
The response format defaults to `url`, and also supports `b64_json`.
watermarkboolean
Whether to add AI-generated watermark, default is `true`.
Please select
output_formatstring
The file format for output images is `jpeg` by default. Only `doubao-seedream-5.0-lite` is supported.
Please select
toolsarray
List of tools that can be called by the model. Currently, only `web_search` is supported. Applicable only to `doubao-seedream-5.0-lite`.
optimize_prompt_optionsobject
Optional prompt word optimization configuration. Only supports `doubao-seedream-5.0-lite`, `doubao-seedream-4.5` (only in `standard` mode), and `doubao-seedream-4.0`.
modestring
Prompt optimization mode. `standard` has higher quality but is slower; `fast` is faster but has relatively lower quality.
Please select
callback_urlstring
The callback URL after image generation is completed, which must be accessible from the public network. Once specified, the interface will return immediately, and the generation result will be asynchronously pushed to this callback address when ready.
asyncboolean
Is it processed in asynchronous mode? When set to `true`, the interface immediately returns `task_id`, without the need to provide `callback_url`, and then the result can be obtained by polling `/seedream/tasks`; if `callback_url` is also provided, the result will be pushed to that callback address.
Please select
Response
ByteDance Seedream Image Generation
Allow Use General Balance
When 'Allow General Balance' is enabled, the general balance is used automatically if an app's balance is insufficient.
Kind reminder: For streaming requests, the above code may not be fully applicable. Please refer to the integration documentation for changes.