Skip to main content
POST

Authorizations

Authorization
string
header
required

Bearer YOUR_API_KEY. Manage keys in API Keys.

Body

application/json
model
string
required
Allowed value: "seedream-5.0-pro"
prompt
string
required

Image generation or edit prompt.

Required string length: 1 - 6000
images
object[]

Reference images. Omit or pass an empty array for text-to-image.

Maximum array length: 10
resolution
enum<string>
default:1K

Output resolution tier.

Available options:
1K,
2K
aspect_ratio
enum<string>

Omit to adapt to references when auto aspect ratio is supported.

Available options:
1:1,
4:3,
3:4,
16:9,
9:16,
3:2,
2:3,
21:9
num
integer
default:1

Output count.

Required range: 1 <= x <= 4

Response

Task accepted.

task_id
string
required

Task ID to poll.

model
string
required

Echoes the supplied model ID.

created_at
string<date-time>
required

Task creation time (UTC).

request_id
string
required

Request ID.