# Seedream 5.5 Layerize

Edit and enhance images with Seedream 5.5 Layerize from fal through one Spiral API key. Seedream 5.5 decomposes an image into a base image and independently editable PNG layers, with layer positions, stacking order, and optional text recognition. It runs in the background and returns images and structured JSON. Pay as you go, with no subscription.

- Provider: fal
- Category: Image
- Runs: In the background
- Returns: image, json
- Released: 2026-11-11
- Tool id: `fal` / `bytedance/seedream/v5.5/layerize`
- Page: https://spiral.ai/tools/fal/bytedance/seedream/v5.5/layerize

## Pricing

$0.0156 per run. `image_size`: auto_1K $0.039 per run plus $0.039 per unit of `max_images`, auto_1.5K $0.039 per run plus $0.039 per unit of `max_images`, otherwise $0.05265 per run plus $0.05265 per unit of `max_images`. Billed on `max_images`, default 30.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` | text |  |  | Optional instructions describing which elements to separate. When empty, the model automatically separates the major elements. Normalized `<bbox>left top right bottom</bbox>` tags may be used for precise coordinate targeting. |
| `image_url` (required) | URL or file |  | — | URL of the image to decompose into a base image and independently editable layers. The image must contain between 512x512 and 6000x6000 total pixels, have an aspect ratio between 1/16 and 16, and be no larger than 30 MB. |
| `image_size` | one of | auto, auto_1K, auto_1.5K, auto_2K | auto | Resolution tier for the output base image and layers. `auto` adapts to the input image while preserving each element's aspect ratio. |
| `max_images` | number (whole) | 2 to 100 | 30 | Maximum number of output images, including the base image. Higher values usually produce a finer decomposition. Above 30, images are always returned as URLs and `sync_mode` is ignored. |
| `enable_text_recognition` | true or false |  | false | If `True`, formatted text layers include a rich-text OCR result in `text_recognition`. |
| `output_format` | one of | jpeg, png | png | Format of the base image. Separated layers always use PNG. |
| `watermark` | true or false |  | false | Whether to add the provider's visible watermark. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "bytedance/seedream/v5.5/layerize",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/example_inputs/kontext_example_input.webp"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=bytedance%2Fseedream%2Fv5.5%2Flayerize

## Common questions

### Seedream 5.5 Layerize

**How much does Seedream 5.5 Layerize cost?**

$0.0156 per run. `image_size`: auto_1K $0.039 per run plus $0.039 per unit of `max_images`, auto_1.5K $0.039 per run plus $0.039 per unit of `max_images`, otherwise $0.05265 per run plus $0.05265 per unit of `max_images`. Billed on `max_images`, default 30. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Seedream 5.5 Layerize through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "bytedance/seedream/v5.5/layerize"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use Seedream 5.5 Layerize?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use Seedream 5.5 Layerize?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

