Doubao Seedream
POST /v1/images/generations
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 |
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" |
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://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"
}
}'
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 2048x2048optimize_prompt_options.mode is currently aligned only as standard for Seedream 4.5 and 5.0 lite; fast is not a public commitment yetSeedream 3.0 stays as a compatibility alias, but the official-alignment focus of this page is now 4.0 / 4.5 / 5.0 lite
