ByteDance · Image API

Seedream 5.0 Pro

seedream-5-0-pro

Quality-first generation with cinematic detail, accurate text, and multi-reference editing.

POST/v1/images/generations

Output count1–1

Reference imagesUp to 10

Resolution tiers1K · 1.5K · 2K

Generation

Generate with Seedream 5.0 Pro

Use ImgRouter's unified request contract and this model ID. The example uses recommended defaults from the route's current parameter guide.

cURL

curl https://api.imgrouter.com/v1/images/generations \
  -H "Authorization: Bearer $IMGROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedream-5-0-pro-generate-001" \
  -d '{
  "model": "seedream-5-0-pro",
  "prompt": "Editorial product photograph, precise materials, soft studio light",
  "size": "auto",
  "resolution": "1.5K",
  "n": 1,
  "output_format": "jpeg"
}'

Request body

modelstring · requiredUse seedream-5-0-pro.

promptstring · requiredGeneration or editing instruction between 1 and 5,000 characters.

sizestringSupported values: auto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 2:1, 1:2, 21:9.

resolutionstringSupported values: 1K, 1.5K, 2K.

ninteger · 1–1Number of output images. Defaults to 1 and cannot exceed 1.

output_formatstringSupported values: jpeg, png.

reference_imagesstring[] · max 10Public HTTPS source images. Send this field to the edit endpoint.

Controls

Supported options

Aspect ratio or size

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

Resolution

1K1.5K2K

Output format

jpegpng

Route notes

Quality-first single-image route; use the Lite route for grouped output.

1.5K is the preferred default because it shares the 1K price tier while improving detail.

Transparent output requires one alpha-channel reference image and PNG output.

Reference workflow

Edit with reference images

Send public HTTPS source images with the same core controls. This route accepts up to 10 reference images.

POST/v1/images/edits

cURL

curl https://api.imgrouter.com/v1/images/edits \
  -H "Authorization: Bearer $IMGROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedream-5-0-pro-edit-001" \
  -d '{
  "model": "seedream-5-0-pro",
  "prompt": "Preserve the subject and composition. Change the scene to soft blue hour.",
  "size": "auto",
  "resolution": "1.5K",
  "n": 1,
  "output_format": "jpeg",
  "reference_images": [
    "https://example.com/reference.jpg"
  ]
}'

Describe both the intended change and the details that must remain consistent. Stable source URLs produce the most reliable edit requests.

Response

Read the completed output

Successful requests return completed image URLs and a request ID. Store the assets you need permanently; routed output URLs may expire.

200 · application/json

{
  "id": "req_01K4…",
  "object": "image.generation",
  "created": 1787424152,
  "data": [
    { "url": "https://static.imgrouter.com/images/req_01K4.webp" }
  ],
  "usage": { "images": 1 }
}

Use GET /v1/requests/{request_id} for reconciliation and GET /v1/balance for the authenticated key's current Credit position.