Skip to main content
POST
Generate images

Authorizations

Authorization
string
header
required

A workspace API key beginning with gengen_live_.

Body

application/json

Normalized synchronous image generation request. Legacy Seedream request aliases remain accepted for existing clients, but new integrations should use the fields documented here.

model
string
required

BytePlus image model ID. Supported Seedream models are seedream-5-0-260128 and dola-seedream-5-0-pro-260628.

Minimum string length: 1
Example:

"seedream-5-0-260128"

prompt
string
required

Text instruction describing the desired image.

Minimum string length: 1
assets
object
controls
object
providerOptions
object

Advanced provider-specific overrides.

Response

The synchronous generation completed successfully.

Standard response fields are listed first. Compatibility aliases can follow them for existing clients.

id
string
required

Synchronous request ID, normally beginning with image:.

model
string
required
status
string
required

Normally succeeded for a successful synchronous response.

outputs
object
required
created_at
string<date-time>
updated_at
string<date-time>
task_id
string

Compatibility alias for id; it is not a pollable task ID.

image_url
string<uri>

Compatibility alias for the first image output.

images
string<uri>[]

Compatibility alias for outputs.images.

created
integer<int64>

Compatibility Unix timestamp in seconds.

data
object[]
usage
object
error