> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Doubao Seedream

> Use the Doubao Seedream family through the OpenAI Images-compatible public contract

> 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

| 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-5-0` | Seedream 3.0         | compatibility only                                             | Legacy    |

<Note>
  “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.
</Note>

## 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

<CodeGroup>
  ```bash cURL theme={null}
  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"
      }
    }'
  ```

  ```bash cURL theme={null}
  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"
      }
    }'
  ```

  ```python Python theme={null}
  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)
  ```
</CodeGroup>

### Response Example

```json theme={null}
{
  "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`