---
title: Seedream 5.5 | Runware Docs
url: https://runware.ai/docs/models/bytedance-seedream-5-5
description: Realistic image generation and consistent multi-turn editing, with native transparency and layer decomposition
---
# Seedream 5.5

![Seedream 5.5](https://assets.runware.ai/covers/bytedance-seedream-5-5.jpg)

Seedream 5.5 is ByteDance's image generation and editing model, focused on visual realism, aesthetics and editing consistency. It supports text-to-image and reference-guided editing with up to 10 input images, keeps unedited areas stable across multi-turn edits, and outputs transparent images from a prompt or from references. It can also split an image into a base image and up to 99 editable layers, returning the text, position, font and style of each text layer, which suits poster, packaging and marketing design workflows.

- **Status**: coming-soon
- **ID**: `bytedance:seedream@5.5`
- **Creator**: ByteDance
- **Capabilities**: Text to Image, Image to Image, Edit, Checkpoint

## Pricing

$0.02 from, per run

**Rates**

- Up to 1.5K (2.36 MP) · per run: `$0.02`
- 2K (above 2.36 MP) · per run: `$0.027`
- Input image · per input image: `$0.008`

[How pricing works](https://runware.ai/docs/models-api/pricing)

## Compatibility & Validation

Either provide `inputs.referenceImages`, or specify `width/height` or `resolution`.

---

`resolution` cannot be used with `width/height`.

---

Inside `settings`, `background` cannot be used with `layerDecomposition`.

---

When `settings.background` is `transparent`, `outputFormat` is limited to `PNG`, `WEBP`.

---

When `settings.layerDecomposition` is `true`, `width/height` cannot be used.

---

When `settings.layerDecomposition` is not `true`, `positivePrompt` is required.

---

When `settings.layerDecomposition` is `true`, `inputs.referenceImages` is limited to 1 item.

---

When `settings.layerDecompositionMaxImages` or `settings.layerDecompositionTextRecognition` is provided, `settings.layerDecomposition` must be `true`.

---

`width` and `height` must be used together.

## Notes

**Aspect ratio:** with reference images and no size, the output keeps the aspect ratio of the reference. Explicit `width` and `height` are **honored exactly** and override that ratio.

**Transparent background:** a `transparent` output works from **any reference**, with or without an alpha channel.

**Layer decomposition pricing:** the base image and each layer are **billed as separate output images**, so `settings.layerDecompositionMaxImages` also caps the cost of a request. The model can return fewer images than that maximum, and a higher maximum usually gives a finer split.

**Text recognition:** `textRecognition` comes back **only on layers recognized as plain text**. Artistic and handwritten text get none, and small or heavily stylized text may get none too. The style fields describe the glyphs themselves, so a rotated layer does not read as `italic` and a solid light color does not read as `translucent`.

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/bytedance-seedream-5-5#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/bytedance-seedream-5-5#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/bytedance-seedream-5-5#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Image output type.

**Allowed values**: `URL` `base64Data` `dataURI`

### [outputFormat](https://runware.ai/docs/models/bytedance-seedream-5-5#request-outputformat)

- **Type**: `string`
- **Default**: `JPG`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`JPG\`: Best for photorealistic images with smaller file sizes (no transparency).
- \`PNG\`: Lossless compression, supports high quality and transparency (alpha channel).
- \`WEBP\`: Modern format providing superior compression and transparency support.

> [!NOTE]
> \*\*Transparency\*\*: If you are using features like background removal or LayerDiffuse that require transparency, you must select a format that supports an alpha channel (e.g., \`PNG\`, \`WEBP\`, \`TIFF\`). \`JPG\` does not support transparency.

**Allowed values**: `JPG` `PNG` `WEBP`

### [outputQuality](https://runware.ai/docs/models/bytedance-seedream-5-5#request-outputquality)

- **Type**: `integer`
- **Min**: `20`
- **Max**: `99`
- **Default**: `95`

Compression quality of the output. Higher values preserve quality but increase file size.

### [webhookURL](https://runware.ai/docs/models/bytedance-seedream-5-5#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/bytedance-seedream-5-5#request-deliverymethod)

- **Type**: `string`
- **Default**: `sync`

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/bytedance-seedream-5-5#request-uploadendpoint)

- **Type**: `string`
- **Format**: `uri`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [safety](https://runware.ai/docs/models/bytedance-seedream-5-5#request-safety)

- **Path**: `safety.checkContent`
- **Type**: `object (1 property)`

Content safety checking configuration for image generation.

#### [checkContent](https://runware.ai/docs/models/bytedance-seedream-5-5#request-safety-checkcontent)

- **Path**: `safety.checkContent`
- **Type**: `boolean`

Enable or disable content safety checking. Increases total generation time.

### [ttl](https://runware.ai/docs/models/bytedance-seedream-5-5#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/bytedance-seedream-5-5#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/bytedance-seedream-5-5#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `20`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [referenceImages](https://runware.ai/docs/models/bytedance-seedream-5-5#request-inputs-referenceimages)

- **Path**: `inputs.referenceImages`
- **Type**: `array of strings`
- **Min items**: `1`
- **Max items**: `10`
- **File size (each)**: `up to 30 MB`
- **Size (each)**: `15 px or more`
- **Aspect ratio (each)**: `1:16 to 16:1`
- **Area (each)**: `up to 36 MP`
- **Area (each) (with layerDecomposition true)**: `0.26 MP or more`

List of reference images (UUID, URL, Data URI, or Base64).

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/bytedance-seedream-5-5#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `bytedance:seedream@5.5`

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [positivePrompt](https://runware.ai/docs/models/bytedance-seedream-5-5#request-positiveprompt)

- **Type**: `string`
- **Required**: conditional — Required when settings.layerDecomposition is not provided
- **Min**: `1`

Text prompt describing elements to include in the generated output.

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [width](https://runware.ai/docs/models/bytedance-seedream-5-5#request-width)

- **Type**: `integer`
- **Min**: `256`
- **Max**: `16383`

Width of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [height](https://runware.ai/docs/models/bytedance-seedream-5-5#request-height)

- **Type**: `integer`
- **Min**: `256`
- **Max**: `16383`

Height of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [resolution](https://runware.ai/docs/models/bytedance-seedream-5-5#request-resolution)

- **Type**: `string`

Resolution preset for the output. When used with input media, automatically matches the aspect ratio from the input. Without a reference image, the model picks the aspect ratio from the prompt.

**Allowed values**: `1K` `1.5K` `2K`

**Settings**

Technical parameters to fine-tune the inference process. These must be nested inside the \`settings\` object.

### [background](https://runware.ai/docs/models/bytedance-seedream-5-5#request-settings-background)

- **Path**: `settings.background`
- **Type**: `string`

Background handling in generated images.

**Allowed values**:

- `auto` Decided by the model from the prompt and `outputFormat`, always opaque for JPG output.
- `transparent` Transparent background.
- `opaque` Solid background, no transparency.

### [layerDecomposition](https://runware.ai/docs/models/bytedance-seedream-5-5#request-settings-layerdecomposition)

- **Path**: `settings.layerDecomposition`
- **Type**: `boolean`

Enables layer decomposition of the reference image. The layers are returned in `outputs.layers` next to the base image. `outputFormat` applies to the base image only, layers are always PNG.

### [layerDecompositionMaxImages](https://runware.ai/docs/models/bytedance-seedream-5-5#request-settings-layerdecompositionmaximages)

- **Path**: `settings.layerDecompositionMaxImages`
- **Type**: `integer`
- **Min**: `2`
- **Max**: `100`

Maximum number of images layer decomposition returns, base image included.

### [layerDecompositionTextRecognition](https://runware.ai/docs/models/bytedance-seedream-5-5#request-settings-layerdecompositiontextrecognition)

- **Path**: `settings.layerDecompositionTextRecognition`
- **Type**: `boolean`

Rich-text OCR for the layers the model recognizes as text, returned in `outputs.layers[].textRecognition`.

### [safetyIdentifier](https://runware.ai/docs/models/bytedance-seedream-5-5#request-settings-safetyidentifier)

- **Path**: `settings.safetyIdentifier`
- **Type**: `string`
- **Min**: `1`
- **Max**: `64`

Identifier of the end user, used by the provider to detect usage-policy violations. Must stay the same for a given user.

**Features**

Standalone addons and post-processing features.

### [watermark](https://runware.ai/docs/models/bytedance-seedream-5-5#request-advancedfeatures-watermark)

- **Path**: `advancedFeatures.watermark`
- **Type**: `object (6 properties)`

Configuration object for adding watermarks to generated videos. Watermarks can be applied using either text or image content with customizable positioning and appearance. You must provide either `text` or `image` content for the watermark, but not both.

**Text watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "© 2025 Company",
    "displayPosition": "bottom-right",
    "opacity": 0.6,
    "fontColor": "#ffffff",
    "bgColor": "#000000"
  }
}
```

**Image watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "image": "c64351d5-4c59-42f7-95e1-eace013eddab",
    "displayPosition": "top-left",
    "opacity": 0.6
  }
}
```

**Tiled watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "PREVIEW",
    "tiled": true,
    "opacity": 0.4,
    "fontColor": "#cccccc"
  }
}
```

#### [text](https://runware.ai/docs/models/bytedance-seedream-5-5#request-advancedfeatures-watermark-text)

- **Path**: `advancedFeatures.watermark.text`
- **Type**: `string`
- **Min**: `2`
- **Max**: `32`

Watermark text.

#### [image](https://runware.ai/docs/models/bytedance-seedream-5-5#request-advancedfeatures-watermark-image)

- **Path**: `advancedFeatures.watermark.image`
- **Type**: `string`

Watermark image (UUID, URL, Data URI, or Base64).

#### [displayPosition](https://runware.ai/docs/models/bytedance-seedream-5-5#request-advancedfeatures-watermark-displayposition)

- **Path**: `advancedFeatures.watermark.displayPosition`
- **Type**: `string`

Watermark position.

**Allowed values**: `top-left` `top-center` `top-right` `center-left` `center-center` `center-right` `bottom-left` `bottom-center` `bottom-right` `tiled`

#### [opacity](https://runware.ai/docs/models/bytedance-seedream-5-5#request-advancedfeatures-watermark-opacity)

- **Path**: `advancedFeatures.watermark.opacity`
- **Type**: `float`
- **Min**: `0.1`
- **Max**: `1`
- **Step**: `0.01`

Watermark opacity.

#### [fontColor](https://runware.ai/docs/models/bytedance-seedream-5-5#request-advancedfeatures-watermark-fontcolor)

- **Path**: `advancedFeatures.watermark.fontColor`
- **Type**: `string`

Text color in hex format.

#### [bgColor](https://runware.ai/docs/models/bytedance-seedream-5-5#request-advancedfeatures-watermark-bgcolor)

- **Path**: `advancedFeatures.watermark.bgColor`
- **Type**: `string`

Background color in hex format.

## Response Parameters

### [taskType](https://runware.ai/docs/models/bytedance-seedream-5-5#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/bytedance-seedream-5-5#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [imageUUID](https://runware.ai/docs/models/bytedance-seedream-5-5#response-imageuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output image.

### [imageURL](https://runware.ai/docs/models/bytedance-seedream-5-5#response-imageurl)

- **Type**: `string`
- **Format**: `uri`

URL of the output image.

### [imageBase64Data](https://runware.ai/docs/models/bytedance-seedream-5-5#response-imagebase64data)

- **Type**: `string`

Base64-encoded image data.

### [imageDataURI](https://runware.ai/docs/models/bytedance-seedream-5-5#response-imagedatauri)

- **Type**: `string`
- **Format**: `uri`

Data URI of the output image.

### [seed](https://runware.ai/docs/models/bytedance-seedream-5-5#response-seed)

- **Type**: `integer`

The seed used for generation. If none was provided, shows the randomly generated seed.

### [NSFWContent](https://runware.ai/docs/models/bytedance-seedream-5-5#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/bytedance-seedream-5-5#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

### [outputs](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs)

- **Path**: `outputs.layers`
- **Type**: `object (26 properties)`

Generated output artifacts.

#### [layers](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers)

- **Path**: `outputs.layers`
- **Type**: `array of objects (25 properties)`
- **Max items**: `99`

Layers decomposed from the reference image, returned when `settings.layerDecomposition` is enabled. Each layer is a PNG with transparency.

##### [description](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-description)

- **Path**: `outputs.layers.description`
- **Type**: `string`

Description of the layer content.

##### [boundingBox](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-boundingbox)

- **Path**: `outputs.layers.boundingBox`
- **Type**: `object (2 properties)`

Position of the layer on the base image, as \[left, top, right, bottom\].

##### [absolute](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-boundingbox-absolute)

- **Path**: `outputs.layers.boundingBox.absolute`
- **Type**: `array of integers`
- **Min items**: `items: 4`

Coordinates in pixels of the base image.

##### [normalized](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-boundingbox-normalized)

- **Path**: `outputs.layers.boundingBox.normalized`
- **Type**: `array of integers`
- **Min**: `0`
- **Max**: `1000`
- **Min items**: `items: 4`

Coordinates on a 0 to 1000 scale.

##### [name](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-name)

- **Path**: `outputs.layers.name`
- **Type**: `string`

Short name of the layer.

##### [url](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-url)

- **Path**: `outputs.layers.url`
- **Type**: `string`
- **Required**: true
- **Format**: `uri`

URL of the output image.

##### [uuid](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-uuid)

- **Path**: `outputs.layers.uuid`
- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output image.

##### [zIndex](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-zindex)

- **Path**: `outputs.layers.zIndex`
- **Type**: `integer`
- **Required**: true
- **Min**: `1`

Stacking order of the layer.

##### [textRecognition](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition)

- **Path**: `outputs.layers.textRecognition`
- **Type**: `object (16 properties)`

Rich-text OCR of the layer, returned when `settings.layerDecompositionTextRecognition` is enabled and the model recognizes the layer as text.

##### [lines](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines)

- **Path**: `outputs.layers.textRecognition.lines`
- **Type**: `array of objects (14 properties)`

Text lines of the layer, in reading order.

##### [boundingBox](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-boundingbox)

- **Path**: `outputs.layers.textRecognition.lines.boundingBox`
- **Type**: `object (2 properties)`

Position of the line on the base image, as \[left, top, right, bottom\].

##### [absolute](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-boundingbox-absolute)

- **Path**: `outputs.layers.textRecognition.lines.boundingBox.absolute`
- **Type**: `array of integers`
- **Min items**: `items: 4`

Coordinates in pixels of the base image.

##### [normalized](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-boundingbox-normalized)

- **Path**: `outputs.layers.textRecognition.lines.boundingBox.normalized`
- **Type**: `array of integers`
- **Min**: `0`
- **Max**: `1000`
- **Min items**: `items: 4`

Coordinates on a 0 to 1000 scale.

##### [runs](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-runs)

- **Path**: `outputs.layers.textRecognition.lines.runs`
- **Type**: `array of objects (10 properties)`

Fragments of the line that share one style.

##### [style](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-runs-style)

- **Path**: `outputs.layers.textRecognition.lines.runs.style`
- **Type**: `object (8 properties)`

Visual style of the fragment, as estimated by the model.

##### [bold](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-runs-style-bold)

- **Path**: `outputs.layers.textRecognition.lines.runs.style.bold`
- **Type**: `boolean`

Whether the text is bold.

##### [foregroundColor](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-runs-style-foregroundcolor)

- **Path**: `outputs.layers.textRecognition.lines.runs.style.foregroundColor`
- **Type**: `string`

Text color.

##### [italic](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-runs-style-italic)

- **Path**: `outputs.layers.textRecognition.lines.runs.style.italic`
- **Type**: `boolean`

Whether the text is italic.

##### [shadow](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-runs-style-shadow)

- **Path**: `outputs.layers.textRecognition.lines.runs.style.shadow`
- **Type**: `boolean`

Whether the text has a drop shadow or glow.

##### [similarFontFamily](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-runs-style-similarfontfamily)

- **Path**: `outputs.layers.textRecognition.lines.runs.style.similarFontFamily`
- **Type**: `string`

Closest matching font, or `unknown` when the model cannot tell.

##### [strikethrough](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-runs-style-strikethrough)

- **Path**: `outputs.layers.textRecognition.lines.runs.style.strikethrough`
- **Type**: `boolean`

Whether the text is struck through.

##### [translucent](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-runs-style-translucent)

- **Path**: `outputs.layers.textRecognition.lines.runs.style.translucent`
- **Type**: `boolean`

Whether the text lets the background show through.

##### [underline](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-runs-style-underline)

- **Path**: `outputs.layers.textRecognition.lines.runs.style.underline`
- **Type**: `boolean`

Whether the text is underlined.

##### [text](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-lines-runs-text)

- **Path**: `outputs.layers.textRecognition.lines.runs.text`
- **Type**: `string`

Text of the fragment, without line breaks.

##### [text](https://runware.ai/docs/models/bytedance-seedream-5-5#response-outputs-layers-textrecognition-text)

- **Path**: `outputs.layers.textRecognition.text`
- **Type**: `string`

Full plain text of the layer, read top to bottom and left to right, with `\n` between lines.