Skip to main content
POST
Seedream 5.5
Generate an image from a text prompt, or add public image URLs to guide an edit. The route returns one image at 1K, 1.5K or 2K. The total is the selected base price plus the price of every supplied reference. For example, a 1K output with two references costs $0.036. Check the live model page for current prices.
string
required
Use seedream-5.5.
string
required
A non-empty creative brief of at most 7,000 characters.
string
default:"auto"
auto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 2:1 or 1:2. Custom pixel sizes are not accepted.
string
default:"1K"
1K, 1.5K or 2K. The selected tier determines the base output price.
string[]
Optional: up to ten public HTTP(S) image URLs. Each reference is billed.
string
default:"auto"
auto, opaque or transparent. Transparent output requires PNG. Describe the isolated subject and review the resulting alpha channel.
string
default:"png"
png or jpeg. Transparent output requires png.
integer
default:"1"
Only 1 is supported.

Generate an image

Edit with references

Send the JSON body to POST /v1/images/generations. Use Prefer: respond-async to receive a task ID immediately, then poll GET /v1/tasks/{id} with the same API key. A waiting request may also return a task if it has not finished. Keep the same idempotency key when retrying an uncertain submission; download temporary result URLs promptly. This integration does not expose custom pixel dimensions, batch output or layer decomposition.