Seedream 5.0 Lite

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",
  "input": {
    "prompt": "Editorial portrait in natural light",
    "resolution": "2K",
    "aspect_ratio": "3:4",
    "max_images": 1
  }
}'

Parameters

Set model to seedream-5. 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 14 items.
`resolution` string · Optional	Output resolution tier. Values are case-sensitive. `2K3K` Default: `2K`
`aspect_ratio` string · Optional	Output proportions; see mode constraints below. `1:12:33:24:33:49:1616:921:9` Default: `1:1`
`max_images` integer · Optional	Requested maximum output count; credits are charged for this count. Range: 1–10. Default: `1`
`sequential_image_generation` string · Optional	Allow sequential image generation. `disabledauto` Default: `disabled`
`web_search` boolean · Optional	Allow web search context. Default: `false`
`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",
  "input": {
    "prompt": "Editorial portrait in natural light",
    "resolution": "2K",
    "aspect_ratio": "3:4",
    "max_images": 1,
    "image_urls": [
      "https://example.com/front.jpg",
      "https://example.com/back.jpg"
    ]
  }
}'

Credits

7 credits per requested image. Successful requests are charged for the requested count, including partial output. Confirmed failed requests are refunded.

Constraints

Reference images plus requested outputs must not exceed 15. Partial output does not trigger an automatic partial refund.

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",
  "status": "processing"
}

Continue readingPoll & download