API

Manage your API access and requests.

Seedream 4.5 · Documentation
Docs Models

Seedream 4.5

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

Parameters

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

ParameterDescription
prompt
string · Required
Describe the image you want to create. Maximum 5,000 characters.
image_urls
string[] · Optional
Public HTTPS reference images. Omit for text-to-image. Up to 14 items.
aspect_ratio
string · Optional
Requested image proportions.
1:14:52:33:24:33:49:1616:921:9
Default: 1:1
resolution
string · Optional
Output resolution tier. Values are case-sensitive.
2K4K
Default: 2K
max_images
integer · Optional
Maximum number of output images. Range: 1–10.
Default: 1
sequential_image_generation
string · Optional
Whether to allow sequential image generation.
disabledauto
Default: disabled

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-4-5",
  "input": {
    "prompt": "Editorial fashion portrait in natural light",
    "aspect_ratio": "4:5",
    "resolution": "2K",
    "max_images": 1,
    "image_urls": [
      "https://example.com/front.jpg",
      "https://example.com/back.jpg"
    ]
  }
}'

Credits

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

Constraints

Reference images plus outputs must not exceed 15.

4:5 requests 1792x2240 at 2K or 3584x4480 at 4K; actual dimensions may differ.

Use returned dimensions when available.

Response

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

JSON
{
  "id": "REQUEST_ID",
  "model": "seedream-4-5",
  "status": "processing"
}
Continue readingPoll & download