Дата обновления: 2026-07-25

Doubao Seedream

POST /v1/images/generations

Crazyrouter exposes the Seedream image family through the OpenAI Images-compatible public contract. Clients keep using /v1/images/generations; ByteDance official and other third-party channels stay internal as providers only.

Public Models

Model	Official counterpart	Customer-facing capability	Doc state
`doubao-seedream-4-0`	Seedream 4.0	text-to-image, image-to-image, multi-reference, grouped output	Beta
`doubao-seedream-4-5`	Seedream 4.5	text-to-image, image-to-image, multi-reference, grouped output	Beta
`doubao-seedream-5-0`	Seedream 5.0 lite	text-to-image, image-to-image, multi-reference, grouped output	Beta
`doubao-seedream-3-0`	Seedream 3.0	compatibility only	Legacy

“Beta” here means the customer-facing contract and official capability definition are aligned first, while production carrier closure and live artifact evidence are still being completed.

Public Contract

Request Parameters

Parameter	Type	Required	Description
`model`	string	Yes	`doubao-seedream-4-0`, `doubao-seedream-4-5`, or `doubao-seedream-5-0`
`prompt`	string	Yes	generation prompt
`image_input`	string or string[]	No	reference image URL(s); official 4.0 / 4.5 / 5.0 lite currently document up to `14` images
`size`	string	No	output size. `Seedream 4.5` officially supports `2K`, `4K`, and explicit width×height inside the official range; `Seedream 5.0 lite` currently requires at least `3,686,400` total pixels
`n`	integer	No	output image count, default `1`
`response_format`	string	No	`url` or `b64_json`
`watermark`	boolean	No	whether to enable watermark
`sequential_image_generation`	string	No	`auto` or `disabled`; used for grouped-output semantics
`optimize_prompt_options`	object	No	official prompt optimization options; `Seedream 4.5` and `5.0 lite` are currently aligned only with `mode: "standard"`

Seedream 5.0 Size Requirement

An explicit WxH value for doubao-seedream-5-0 must satisfy:

width × height >= 3,686,400

Size	Total pixels	Meets the minimum
`2688x1152`	`3,096,576`	No; the upstream returns `InvalidParameter`
`2048x2048`	`4,194,304`	Yes; the model’s other dimension and aspect-ratio limits still apply

Do not retry the same invalid size or treat this error as proof that the model is unavailable. If the error log says “Service temporarily unavailable” or “The requested model is temporarily unavailable,” check size first; the regular error log may hide the more specific upstream size error.

Reference Image Limits

Seedream 4.0, 4.5, and 5.0 lite officially support up to 14 reference images
maximum single reference image size is 10MB
officially supported input formats now include jpeg, png, webp, bmp, tiff, and gif
officially supported input aspect-ratio range is 1/16 to 16

Request Examples

curl -X POST https://api.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedream-4-5",
    "prompt": "A premium product poster featuring a transparent glass perfume bottle with soft morning haze lighting and a minimal Chinese title",
    "size": "2K",
    "n": 1,
    "response_format": "url",
    "watermark": false,
    "optimize_prompt_options": {
      "mode": "standard"
    }
  }'

curl -X POST https://api.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedream-4-5",
    "prompt": "Generate a group of product posters for the same character while keeping the subject consistent and varying the camera angle and composition",
    "image_input": [
      "https://example.com/ref-1.png",
      "https://example.com/ref-2.png"
    ],
    "size": "2K",
    "sequential_image_generation": "auto",
    "response_format": "url",
    "optimize_prompt_options": {
      "mode": "standard"
    }
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.crazyrouter.com/v1"
)

response = client.images.generate(
    model="doubao-seedream-4-5",
    prompt="A premium product poster featuring a transparent glass perfume bottle with soft morning haze lighting and a minimal Chinese title",
    size="2K",
    n=1
)

print(response.data[0].url)

Response Example

{
  "created": 1709123456,
  "data": [
    {
      "url": "https://crazyrouter.com/files/seedream_image_abc123.png"
    }
  ]
}

Official Billing Truth

The currently confirmed official truth is billing per successfully generated image, not token-display pricing.

Model	Official billing	Official price	Current doc state
`doubao-seedream-4-0`	per image	`$0.03 / image`	officially aligned
`doubao-seedream-4-5`	per image	`$0.04 / image`	officially aligned
`doubao-seedream-5-0`	per image	official price still pending confirmation	Beta

Alignment Notes

The customer-facing contract has been narrowed to /v1/images/generations
Seedream 4.5 currently centers on official 2K and 4K sizing, with default 2048x2048
optimize_prompt_options.mode is currently aligned only as standard for Seedream 4.5 and 5.0 lite; fast is not a public commitment yet
Seedream 3.0 stays as a compatibility alias, but the official-alignment focus of this page is now 4.0 / 4.5 / 5.0 lite

Chat - OpenAI

Chat - Claude

Chat - Gemini

Chat - Responses API

Генерация изображений

Генерация видео

Аудио

Embeddings и rerank

Другие API

Справочник

Doubao Seedream

Doubao Seedream

Public Models

Public Contract

Request Parameters

Seedream 5.0 Size Requirement

Reference Image Limits

Request Examples

Response Example

Official Billing Truth

Alignment Notes

​Doubao Seedream

​Public Models

​Public Contract

​Request Parameters

​Seedream 5.0 Size Requirement

​Reference Image Limits

​Request Examples

​Response Example

​Official Billing Truth

​Alignment Notes

Doubao Seedream

Public Models

Public Contract

Request Parameters

Seedream 5.0 Size Requirement

Reference Image Limits

Request Examples

Response Example

Official Billing Truth

Alignment Notes