Seedream 5 Pro Layers API for Editable Image Layers

Send exactly one image to POST /api/v1/images/generations with model: seedream-5-pro-layers. ByteDance's model returns a base image plus up to 16 independently editable layers, each a transparent PNG with a z_index and a bounding box, so you can rebuild or rearrange the artwork.
Get API Key
Poster artwork separated into floating transparent glass layers above a desk

From One Flat Image to a Layer Stack

Hands lifting a cut-paper bird from a layered paper collage
Layout grid on a drafting table with acetate sheets aligned by registration marks
Stained glass panels leaning against a sunlit window showing separate colored pieces
One input image, an optional prompt and an output tier.

Seedream 5 Pro Layers Request Fields and Limits

model

Always <code>seedream-5-pro-layers</code>.

image_list (required)

Exactly one image to split, as <code>[{"url": "https://…"}]</code>.

prompt

Optional, 1 to 2000 characters. Names the elements to split in plain language or with <code>&lt;bbox&gt;</code> coordinates; omit it for an automatic split.

image_size

<code>auto</code> (default, follows the input image's size), <code>1K</code>, <code>1.5K</code> or <code>2K</code>. Only tier names are accepted; pixel values such as 2048x2048 are rejected.

output_format

<code>jpeg</code> (default) or <code>png</code>, for the base image only. Layers are always transparent PNG.

Result

The base image plus up to 16 layers, each with <code>z_index</code>, <code>bounding_box.absolute</code>, <code>bounding_box.normalized</code>, <code>name</code> and <code>description</code>.
Charged per request, not per layer returned.

Seedream 5 Pro Layers API Pricing

1K, 1.5K or auto: 14.66 tokens ($0.2932) per request

Covers the base image and all layers the model returns.

2K: 15.53 tokens ($0.3106) per request

The higher tier for larger artwork.

Billed as base + 16 layers

The model decides how many layers to produce, so every request is billed as one base image plus 16 layers regardless of how many come back.

Layers at half the image rate

Layers are billed at half the rate of a normal image, so one split costs far less than 17 separate generations. Failed jobs are refunded automatically.

Integrate the Seedream 5 Pro Layers API

1. Create an API key
1

1. Create an API key

Generate a key at /keys and send it as Authorization: Bearer <key>.
2. Submit one image
2

2. Submit one image

POST {"model": "seedream-5-pro-layers", "image_list": [{"url": "https://…"}], "image_size": "2K"} to /api/v1/images/generations; add prompt to guide the split.
3. Wait for the job
3

3. Wait for the job

Store the img_uuid and poll GET /api/v1/jobs/detail, or receive the same body at your custom_callback_url.
4. Recompose the layers
4

4. Recompose the layers

Sort the result items by z_index and place each layer using its bounding box. Download all files before the links expire, 24 hours after the job finishes.
Turn flattened images back into material a design tool can work with.

What Developers Build with Seedream 5 Pro Layers

Editable design imports

Let users drop a flat poster or banner into your editor and get movable, separately editable elements.

Template generation

Split finished creatives into reusable parts, then swap the product or headline layer for new variants.

Motion and parallax

Animate layers independently by depth for parallax scrolls, animated banners or short motion graphics.

Asset extraction

Pull individual objects out of an illustration as transparent PNGs, named and described, for asset libraries.
Inputs, layer output and pricing.

Seedream 5 Pro Layers API FAQ

Start Building with the Seedream 5 Pro Layers API