Skip to main content
Last updated: 2026-06-06

​
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

ModelOfficial counterpartCustomer-facing capabilityDoc state
doubao-seedream-4-0Seedream 4.0text-to-image, image-to-image, multi-reference, grouped outputBeta
doubao-seedream-4-5Seedream 4.5text-to-image, image-to-image, multi-reference, grouped outputBeta
doubao-seedream-5-0Seedream 5.0 litetext-to-image, image-to-image, multi-reference, grouped outputBeta
doubao-seedream-5-0Seedream 3.0compatibility onlyLegacy
“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

ParameterTypeRequiredDescription
modelstringYesdoubao-seedream-4-0, doubao-seedream-4-5, or doubao-seedream-5-0
promptstringYesgeneration prompt
image_inputstring or string[]Noreference image URL(s); official 4.0 / 4.5 / 5.0 lite currently document up to 14 images
sizestringNooutput size. Seedream 4.5 officially supports 2K, 4K, and explicit width×height inside the official range
nintegerNooutput image count, default 1
response_formatstringNourl or b64_json
watermarkbooleanNowhether to enable watermark
sequential_image_generationstringNoauto or disabled; used for grouped-output semantics
optimize_prompt_optionsobjectNoofficial 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://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.
ModelOfficial billingOfficial priceCurrent doc state
doubao-seedream-4-0per image$0.03 / imageofficially aligned
doubao-seedream-4-5per image$0.04 / imageofficially aligned
doubao-seedream-5-0per imageofficial price still pending confirmationBeta

​
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