Seedream 5.0 Pro – Flux1 AI API

ByteDance's flagship Seedream for dense layouts, legible text and multi-reference edits, at 1K, 1.5K or 2K.

ByteDanceimage

Model id: seedream-5-0-pro
Price: 1K 61.5K 62K 10credits / image
Output: 1K–2K
Reference images: Up to 10
Typical time: 60–180 seconds

Aspect ratios

auto1:14:33:416:99:163:22:32:11:221:9

POST/api/v1/generations

JSON requestAsynchronousOne image per request

Pricing depends on resolution. Select a tier in the example to see the cost. The first reference image is included; each additional one adds 1 credit. Check credits_refunded to confirm a refund; unresolved submissions may require review.

Jump to request examples ↓

Authorization

Authorizationstringrequired

Bearer fx1_live_… — send your API key in the request header. Requires a completed paid purchase; new generations also require enough credits.

Idempotency-Keystringoptional

Use one unique value per generation and reuse it with the same body on retries. Printable ASCII, no spaces. A different body with the same key returns 409.

Maximum length: 128 characters

Manage API keys ↗

Request body

modelstringrequired

Use this exact model ID in the top-level request body.

seedream-5-0-pro

promptstringrequired

Describe the image to create, or the changes to make to your reference images. Whitespace is trimmed.

Maximum length: 5,000 characters

imagesstring[]optional

Optional reference images. Use publicly accessible HTTPS URLs or data:image/* base64 URIs (up to 20,000,000 characters per entry). Omit for text-to-image.

Maximum items: 10

aspect_ratiostringoptional

Output width-to-height ratio. Auto lets the model choose.

Default: 1:1

auto1:14:33:416:99:163:22:32:11:221:9

resolutionstringoptional

Output resolution tier; values are case-insensitive. Omit or leave empty to use the default.

Default: 1.5K

1K1.5K2K

Response & next step

A successful submission returns 202 and a generation id. Poll GET /api/v1/generations/{id} every 2–3 seconds until the status is succeeded or failed.

Read the result URL from output.images[0].url. Download it before expires_at (30 days after storage). On failure, inspect error and credits_refunded.

Generation lifecycle →Error reference →

Build your request

6 credits / image

ModeResolution

Examples only. Run on your server with your API key.

# Set FLUX1_IDEMPOTENCY_KEY once per generation; reuse it on retries.
curl --request POST 'https://flux1.ai/api/v1/generations' \
  --header "Authorization: Bearer $FLUX1_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: ${FLUX1_IDEMPOTENCY_KEY:?Set a unique key for this generation}" \
  --data '{
  "model": "seedream-5-0-pro",
  "prompt": "A ceramic cup on a linen table, soft morning light",
  "aspect_ratio": "1:1",
  "resolution": "1.5K"
}'

202 · POST /api/v1/generations

{
  "id": "gen_example",
  "status": "queued",
  "model": "seedream-5-0-pro",
  "media_type": "image",
  "credits": 6,
  "credits_refunded": false,
  "input": {
    "prompt": "A ceramic cup on a linen table, soft morning light",
    "aspect_ratio": "1:1",
    "resolution": "1.5K"
  },
  "output": null,
  "expires_at": null,
  "content_expired": false,
  "error": null,
  "created_at": "2026-09-07T08:00:00.000Z",
  "completed_at": null
}

Model notes

seedream-5-0-pro is Seedream 5.0 Pro. Seedream 5.0 Lite and Seedream 5.0 Flash are separate models with their own ids.
Choose output size with resolution: 1K, 1.5K or 2K, case-insensitive. 1K and 1.5K cost the same, so 1.5K is the default; 2K costs more. There is no 4K tier.
The first reference image is included in the price. Each additional one adds pricing.extra_image_credits, and the charge on the generation reflects the references actually sent. Repeated URLs are sent and billed once.
References can be HTTPS URLs or data:image/…;base64, URIs. Omit images for text-to-image.
Pro plans the layout before it renders, so it is the slowest image model here. estimated_seconds reflects typical runs; 2K output and many references take longer. Poll the generation rather than holding a request open.
Fields this model does not use are ignored. Drafting? Send the same body to seedream-5-0-flash first, then switch model for the final version.