Spiral gives your agent every tool with one account. Browse the tools →

falImageAvailable nowReleased 2026-11-11

Seedream 5.5 Layerize

bytedance/seedream/v5.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.

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

FieldKindDefaultDescription
prompttext

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 requiredURL 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_sizeone 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_imagesnumber (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_recognitiontrue or falsefalse

If True, formatted text layers include a rich-text OCR result in text_recognition.

output_formatone of
jpeg, png
png

Format of the base image. Separated layers always use PNG.

watermarktrue or falsefalse

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.