Skip to main content
Use seedream-5-5-pro with the synchronous image generation endpoint. Choose a tab for text-to-image generation, reference-image editing, or transparent image output.
To request transparent output, set background to transparent and output_format to png. A request without background: "transparent" returns an opaque image.

Create an image

POST /v1/images/generations
cURL
string
required
Use seedream-5-5-pro.
string
required
Text prompt for image generation. Describe the subject, composition, style, lighting, materials, and any text to render.
string
Accepts 1K, 1.5K, and 2K. The example uses 1K, which returned 1248x832.
string
Return the generated image as a URL or Base64 data.
string
Use png or jpeg. Both formats were accepted. Use png when you need an alpha channel.
boolean
Whether to add an AI-generated watermark.

Create response

200

Headers

string
required
Bearer authentication. Use Bearer YOUR_API_KEY.
string
default:"application/json"
required
Request body format.

Response fields

string
Model identifier reported in the response. This request returned dola-seedream-5-5-261028.
integer
Creation time as a Unix timestamp in seconds.
object[]
Generated image results.
string
Temporary image URL when response_format is url.
string
Base64 image data when response_format is b64_json.
string
Generated image dimensions.
string
Generated image format.
string
Background mode reported for the generated image: opaque or transparent.
integer
Number of generated images.
integer
Number of input images, when applicable.
integer
Output token count.
integer
Total token count.

Error responses

Error responses use an error object with code, message, and type fields.
object
Error information.
string
Machine-readable error code.
string
Human-readable error message.
string
Error category.
Invalid request or unsupported parameter value.