# Seedream 5.5 API (https://wanapi.app/docs/seedream-5-5)





Seedream 5.5 generates one image from text or up to 10 reference images. Layer decomposition takes one image and returns a base image plus transparent layers, with an optional printed-text recognition result.

[Try the Playground](/models/seedream-5-5#playground) · [OpenAPI JSON](/models/seedream-5-5/openapi.json) · [Integration tutorial](/blog/seedream-5-5-api-guide)

## Authentication and endpoints [#authentication-and-endpoints]

Use your Wan API key as a Bearer token. One key accesses all available models and groups; you do not select a group on the key.

| Method | URL                                                       | Purpose               |
| ------ | --------------------------------------------------------- | --------------------- |
| POST   | `https://api.wanapi.app/seedream55/v1/images/generations` | Submit one image task |
| GET    | `https://api.wanapi.app/seedream55/v1/tasks/{id}`         | Read that task        |

The model ID is &#x2A;*`seedream-5-5`**. These are asynchronous endpoints. Submit once, save the task ID and poll it until `completed` or `failed`. An uncertain network response is not permission to submit again.

## Generate an image [#generate-an-image]

```bash
curl https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5",
    "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning light. No text.",
    "size": "1K"
  }'
```

An accepted request returns a task rather than image bytes:

```json
{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}
```

```bash
curl https://api.wanapi.app/seedream55/v1/tasks/task_example \
  -H "Authorization: Bearer $WAN_API_KEY"
```

Poll the same ID every few seconds. Keep it if your application stops waiting, so it can resume later. Task IDs and timestamps in this guide are illustrative.

## Parameters [#parameters]

| Parameter                                      | Type             | Default                    | Rules                                                                                              |
| ---------------------------------------------- | ---------------- | -------------------------- | -------------------------------------------------------------------------------------------------- |
| `model`                                        | string           | required                   | `seedream-5-5`                                                                                     |
| `prompt`                                       | string           | required for generation    | Optional for layer decomposition.                                                                  |
| `image`                                        | URL or URL array | none                       | Up to 10 references; exactly one for layers. Every reference is billed.                            |
| `size`                                         | string           | `2K`, or `auto` for layers | See the size rules below.                                                                          |
| `output_format`                                | string           | `png`                      | `png` or `jpeg`. For layers, controls only the base image.                                         |
| `background`                                   | string           | `auto`                     | `auto`, `opaque`, `transparent`. Transparent requires PNG. Omit this field entirely in layer mode. |
| `layer_decomposition`                          | boolean          | `false`                    | Split one reference into a base image and transparent PNG layers.                                  |
| `layer_decomposition_options.max_images`       | integer          | `30`                       | Total image cap, 2–100, including the base. Only for layer mode.                                   |
| `layer_decomposition_options.text_recognition` | boolean          | `false`                    | Request printed-text metadata in layers. Only for layer mode.                                      |
| `optimize_prompt_options.mode`                 | string           | `standard`                 | The only supported mode is `standard`.                                                             |
| `watermark`                                    | boolean          | `false`                    | Request an AI-generated watermark.                                                                 |
| `content_filter`                               | boolean          | `true`                     | The customer API accepts false. In the Playground, only administrators may disable it.             |

There is no supported `n`, `seed`, `stream`, `resolution`, `aspect_ratio`, `image_urls` or `response_format` parameter. Undocumented fields are discarded and do not enable those features. Multipart uploads, Base64 and data URIs are rejected.

## Output size [#output-size]

Generation accepts `1K`, `1.5K`, `2K` or exact `WIDTHxHEIGHT` pixels. Exact sizes must total **921,600–4,624,220 pixels** and have an aspect ratio from **1:16 to 16:1**. For example, `2048x1152` is valid. A ratio such as `16:9` is not a size value.

Layer decomposition accepts `auto`, `1K`, `1.5K` or `2K`; exact pixels are not supported in that mode. `auto` follows the input and reserves the higher output rate. The model has no 3K or 4K preset.

## Reference images and editing [#reference-images-and-editing]

Provide public HTTP(S) URLs hosted by you, without embedded credentials. Supported formats are JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC and HEIF, up to 30 MB per image and at most 36,000,000 pixels in total. AVIF and JP2 are unsupported. A URL must serve an image directly without a login or browser challenge.

```json
{
  "model": "seedream-5-5",
  "prompt": "Change the scene to a snowy winter night. Keep the lighthouse and its composition.",
  "image": "https://your-cdn.example/lighthouse.jpg",
  "size": "2K"
}
```

For multiple references, pass a URL array and explain each image's role in the prompt. The result is still one image. Reference URLs in examples are placeholders: replace them with your own reachable files.

## Layer decomposition and text recognition [#layer-decomposition-and-text-recognition]

```json
{
  "model": "seedream-5-5",
  "image": "https://your-cdn.example/poster.png",
  "size": "1K",
  "layer_decomposition": true,
  "layer_decomposition_options": {
    "max_images": 4,
    "text_recognition": true
  }
}
```

The cap includes the base image; `4` means at most four returned images, not four layers plus a base. The model may return fewer. Leave `prompt` out for automatic separation, or name the elements to separate. A prompt can suppress text that it excludes.

Layers are PNG files with transparency. Rebuild the image in ascending `z_index` order, with the base at 0. If a bounding box is provided, resize the layer to that box before positioning it: the layer file's pixel dimensions can differ from its placement dimensions.

Optional `text_recognition` contains full `text` and `lines`. Each line can include a `bounding_box` and styled `runs`. A run's `style` can include `similar_font_family`, `foreground_color` (`#RRGGBB`), `bold`, `italic`, `underline`, `strikethrough`, `shadow` and `translucent`. These are model estimates. Artistic or handwritten lettering may have no text result; treat the field as optional.

## Completed response [#completed-response]

```json
{
  "id": "task_example",
  "model": "seedream-5-5",
  "status": "completed",
  "created_at": 1794432000,
  "output": {
    "data": [
      {
        "url": "https://api.wanapi.app/v1/tasks/task_example/artifacts/image-1/content?access=EXAMPLE",
        "size": "1248x832",
        "output_format": "png"
      }
    ]
  }
}
```

Each image has a `url` and `size`. Other fields can include `output_format`, `background`, `z_index`, `name`, `description`, `bounding_box` and `text_recognition`. `bounding_box.absolute` is `[left, top, right, bottom]` in base-image pixels. `bounding_box.normalized` uses the same coordinates scaled to 0–1000. Do not assume optional metadata exists on every image.

Treat image URLs as private download links and save the files you need. A URL carrying an `access` token can be opened without exposing your account API key.

## Pricing [#pricing]

<Seedream55ModelPricing />

The output pixel boundary is **2,610,000 pixels**. Calculate the bill as:

```text
lower-band output count × lower-band rate
+ higher-band output count × higher-band rate
+ reference image count × reference rate
```

Every reference is billed, including the first and the source image for layers. Generation and layers use the same output rates. Submission reserves one output, or the layer `max_images` cap, plus references. Completion uses each returned image's own pixel dimensions and releases the unused reservation. The accepted task keeps its price snapshot even if rates change while it runs. Failed tasks are refunded.

## Errors and retry behavior [#errors-and-retry-behavior]

Invalid parameters are rejected before submission. Insufficient balance or key quota prevents generation. Authentication and ownership checks apply to both submission and polling. A failed task returns `status: "failed"` with an `error` object.

Retry a failed status read with the same task ID. **Do not automatically repeat a generation POST**, including after a timeout: it may already have been accepted. While the upstream reports normal progress, the task remains pending. A task with no normal upstream status or successful delivery for three continuous hours fails and is refunded.

See the [Seedream 5.5 tutorial](/blog/seedream-5-5-api-guide) for an application loop that saves and resumes the task ID.
