Seedream 5.5 Layerize
bytedance/seedream/v5.5/layerizeEdit 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.
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
- Runs
- In the background
- Returns
- image, json
- 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 | Default | Description |
|---|---|---|---|
prompt | text | Optional instructions describing which elements to separate. When empty, the model automatically separates the major elements. Normalized | |
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. |
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 |
enable_text_recognition | true or false | false | If |
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. |
Same request in code
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"
}
}'Frequently asked questions
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.