Seedream 5.0 Pro

Generate images from text or edit images using references.

POST

/api/v1/generations

Example request

Set your FLUX_API_KEY before running. See the parameters below for supported settings.

cURL

curl https://api.flux-context.org/api/v1/generations \
  -H "Authorization: Bearer $FLUX_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedream-5-pro",
  "input": {
    "prompt": "Editorial portrait in natural light",
    "resolution": "2K",
    "aspect_ratio": "3:4"
  }
}'

Parameters

Set model to seedream-5-pro. These fields belong inside input.

Parameter	Description
`prompt` string · Required	Describe the desired output. Minimum 1 characters. Maximum 5,000 characters.
`image_urls` string[] · Optional	Public HTTPS reference images. Video image order and count depend on mode. Up to 10 items.
`resolution` string · Optional	Output resolution tier. Values are case-sensitive. `1K2K`
`aspect_ratio` string · Optional	Output proportions; see mode constraints below. `1:12:33:24:33:49:1616:921:9`
`size` string · Optional	Custom widthxheight, in multiples of 16. 921,600–4,194,304 pixels; ratio 1:16–16:1. Cannot combine with resolution or aspect_ratio. Maximum 64 characters.
`output_format` string · Optional	Output file format. `jpegpng` Default: `jpeg`

Reference media

Use your own publicly accessible HTTPS media URLs. Links must remain valid throughout queueing and generation. Base64 and file upload bodies are not supported by this endpoint.

Image-to-image

cURL

curl https://api.flux-context.org/api/v1/generations \
  -H "Authorization: Bearer $FLUX_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedream-5-pro",
  "input": {
    "prompt": "Editorial portrait in natural light",
    "resolution": "2K",
    "aspect_ratio": "3:4",
    "image_urls": [
      "https://example.com/front.jpg",
      "https://example.com/back.jpg"
    ]
  }
}'

Credits

Preset	Credits
1K	10
2K	20

Custom sizes above 2,360,000 pixels use the higher tier.

The first reference image is included. Each additional reference image costs 1 credit.

Constraints

Omitting size uses resolution 1K and aspect_ratio 1:1 by default.

Use custom size or preset resolution/aspect_ratio, not both. Layer decomposition is not supported.

Use returned dimensions when available.

Response

A successful submission returns HTTP 202 and a request ID. Response excerpt:

JSON

{
  "id": "REQUEST_ID",
  "model": "seedream-5-pro",
  "status": "processing"
}

Continue readingPoll & download