Seedream 5.0 Pro API

ByteDance Seedream 5.0 Pro: photoreal images, multilingual text and up to 10-reference editing.

ByteDance·ImageAvailable

from$0.026/ image$0.02910% off

Model IDseedream-5.0-pro

text-to-imageimage-edit

Input

Text · Image

Output

Image

Provider

6 providers

Aspect ratio

1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9

Resolution

1K · 2K

Images

1 – 4

Last 7 days · not enough recent requests for stats yet.

Seedream 5.0 Pro pricing

Prices are per unit; requests without a provider are routed to the cheapest provider that supports your parameters.

Option1K2K
All options
$0.026 / image
3 Credits$0.02910% off
$0.053 / image
6 Credits$0.05910% off

Try Seedream 5.0 Pro before you integrate

Test output quality, compare provider prices and estimate cost before writing any code.

Provider
Image
Estimated cost

Input

prompt
image_urls
aspect_ratio
resolution
num_images

Result

Idle
Your generation will appear here.

Provider prices for this request

Enter a prompt to compare provider prices.

Seedream 5.0 Pro prompt examples

Ready-to-use prompts. Load one into the playground and tweak it.

Source
Scene

40 prompts

A young foreign woman wearing an elegant one-piece swimsuit and a light linen cover-up

A young foreign woman wearing an elegant one-piece swimsuit and a light linen cover-up, sitting gracefully on a large smooth beach rock near the ocean, one leg relaxed naturally, one hand resting on the linen fabric, hair softly moved by the sea breeze, calm confident expression, soft daylight, tasteful and non-provocative fashion editorial photography, refined composition, luxury resort atmosphere, realistic, artistic, cinematic

A professional young foreign woman standing in a futuristic AI studio, front-facing up

A professional young foreign woman standing in a futuristic AI studio, front-facing upper body portrait, wearing a clean white blazer, calm confident expression, direct eye contact, subtle smile, blue holographic technology background, soft cinematic lighting, realistic skin texture, premium corporate campaign style, photorealistic, high detail, 9:16

Seedream 5.0 Pro API reference

Endpoints, request fields and runnable examples for this model.

Base URL

https://01router.com/api/v1
llms.txt

Quick start

Set API_KEY to your project key, then run a sample from your server. Replace example media URLs with your own public URLs.

Auto-routing chooses a provider that supports the request. Select a provider to see its input constraints and pinned request examples.

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "seedream-5.0-pro",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  }
}
JSON

# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"

Endpoints

Only endpoints relevant to this model are listed. Paths below include /api/v1. Click an endpoint to read its usage.

Authentication

Send your API key as a Bearer token. Requests are billed to the key owner's credits.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Get an API key

Input

Send JSON with Content-Type: application/json. Model parameters belong inside input; model, provider and callback_url are top-level fields.

Request body

NameTypeRequiredDescription
modelstringYes"seedream-5.0-pro"
providerstringNoPin a provider; omit to auto-route to the cheapest. One of: fal | replicate | wavespeed | kie | apimart | evolink
inputobjectYesModel parameters, see the input fields below.
callback_urlstringNoOptional public HTTPS webhook URL. The final task result is signed and delivered here; polling remains available.

input · input fields

Required fields are marked explicitly. Other fields use the listed defaults when omitted.

NameTypeRequiredValuesDefault
prompt*stringYes——
image_urls
Optional — switches to image editing
string[]NomaxItems: 10—
aspect_ratiostringNo1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 3:2 | 2:3 | 21:91:1
resolutionstringNo1K | 2K1K
num_imagesintegerNomin: 1 · max: 41
Callbacks →

Output

Creating a task does not mean generation has finished. Keep its id, poll until succeeded or failed, then read outputs or error. Amounts below are illustrative; actual charges depend on the request.

queued→processing→succeeded / failed

Task submitted

{
  "id": "gen_example",
  "object": "generation",
  "model": "seedream-5.0-pro",
  "type": "image",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

Task completed

{
  "id": "gen_example",
  "object": "generation",
  "model": "seedream-5.0-pro",
  "type": "image",
  "provider": "fal",
  "status": "succeeded",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  },
  "outputs": [
    "https://example.com/output.png"
  ],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}

Response fields

NameTypeRequiredDescription
idstringYesGeneration ID. Use it to query or cancel this task.
objectstringYesgeneration
modelstringYesseedream-5.0-pro
typestringYesimage
providerstringYesProvider
statusstringYesqueued → processing → succeeded / failed. Stop polling at either terminal state.
inputobjectYesModel parameters, see the input fields below.
outputsstring[]YesResult URLs. Empty while processing; read after succeeded and save the files promptly.
errorstring | nullYesFailure reason, or null when no failure is reported.
creditsnumberYesCredits charged for this request.
price_usdnumberYesRequest price in USD.
created_atstringYesCreation time in ISO 8601 format.
completed_atstring | nullYesCompletion time in ISO 8601 format; null before completion.

Get the result

Poll every few seconds until status is succeeded or failed. Output URLs are provider-hosted and may expire — download them promptly. Or pass callback_url to get the result pushed.

curl "https://01router.com/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

queued → processing → succeeded / failed. Stop polling at either terminal state. Result URLs. Empty while processing; read after succeeded and save the files promptly.

Cancel a task

Cancellation depends on provider support and task state. A confirmed cancellation returns status: failed and error: Canceled by user. Unsupported or completed tasks return 409 not_cancelable.

curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

Quote

Same body as creating a generation. Returns every available provider sorted by price, plus the ones that cannot serve the request and why.

curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "seedream-5.0-pro",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  }
}
JSON

OpenAI-compatible images

For OpenAI SDK integrations, use this endpoint with top-level prompt. It waits for the result and returns data[].url. For asynchronous tasks and the full model parameter set, use /generations.

curl "https://01router.com/api/v1/images/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "seedream-5.0-pro",
  "prompt": "A cinematic shot of a red fox running through snow"
}
JSON
{
  "created": 1792915200,
  "data": [
    {
      "url": "https://example.com/output.png"
    }
  ]
}

Model schema

This public endpoint returns the model parameters and each provider’s supported constraints and prices.

curl "https://01router.com/api/v1/models/seedream-5.0-pro"

Errors

Check the HTTP status and error.message. Fix the request before retrying validation or authentication errors. A failed generation is reported in status and error on the task itself.

{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}

400Invalid body or parameter value

401Missing or invalid API key

402Not enough credits

404Unknown model or generation

409The task cannot be canceled (already finished, or the provider does not support canceling)

429Too many requests — retry after the given seconds

502Every provider rejected the task (credits refunded)

Auth, routing, billing and error codes are covered in →

Use with AI

Give your coding assistant this model reference: endpoints, input constraints, output fields and request examples in plain text.

Open llms.txt

How does Seedream 5.0 Pro compare?

Specs and starting prices side by side. Test with the same prompt before you choose.

Seedream 5.0 ProSeedream 5.0 FlashGPT Image 2.5 FlareGPT Image 2.5 Sunburst
VendorByteDanceByteDanceOpenAIOpenAI
Starting price$0.026 / image$0.012 / image$0.0053 / image$0.0053 / image
InputText · ImageText · ImageText · ImageText · Image
Provider6 providers5 providers6 providers6 providers
Aspect ratio1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:91:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:91:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:31:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3
Resolution1K · 2K1K · 2K——
Images1 – 41 – 41 – 41 – 4

Seedream 5.0 Pro API FAQ

What can Seedream 5.0 Pro do?

It is ByteDance's high-end image model for text-to-image and editing, with realistic portraits, dense layouts such as infographics, and multilingual text rendering.

How many reference images can I use?

Up to 10 reference images in image_urls, for example to put a garment from one image onto a person in another, or to build a product scene from several shots.

What resolutions are supported?

1K and 2K. 2K is the maximum; there is no 4K output.

How do I render text?

Put on-image text in double quotes. It supports English, Chinese and several other languages.

How is it billed on 01router?

Per generated image; 2K costs more than 1K on most providers. See the pricing table. Failed generations are refunded.

Related models

Other models you can call with the same API key.