Text of dev.runwayml.com › learn › seedream-5-5-layers-api as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Seedream 5.5 Layers API: access, pricing, code | Runway Dev

Summary Runway Dev gives you the official Seedream 5.5 Layers API from ByteDance. Seedream 5.5 Layers splits one image into a base image and a set of transparent PNG layers, one per object. The base image is the scene with those objects lifted out and the space behind them filled in, and each layer comes with its position and stacking order. This page covers access, pricing, what a request returns, how to choose the layers, how to put them back together and code.

What is Seedream 5.5 Layers? Seedream 5.5 Layers is the layer decomposition mode of Seedream 5.5, ByteDance’s image generation and editing model , released in November 2026. It takes one PNG or JPEG image and returns it as separate, editable pieces: a base image and a transparent PNG for each element it finds, such as a piece of furniture, a product, a plant or a frame on a wall. Seedream 5.5 Layers is built for work that starts from a finished picture and needs to change part of it: move or remove an object, swap a product, restyle a room around the same furniture or hand a design team a layered file instead of a flat one.

It splits the image on its own, or follows a prompt that names the elements to separate. The pair above is one request with no prompt: drag the divider to compare the source image with the base image the task returned, the room with every object it separated taken out. What are the ways to use Seedream 5.5 Layers on Runway Dev? You can use Seedream 5.5 Layers on Runway Dev three ways, all from one account: Way in Best for What you need Playground Splitting an image, then copying the request as code A Runway Dev account API and SDKs Calling Seedream 5.5 Layers from your own code An API key, plus the Node or Python SDK if you want one Coding agent Having Claude Code, Codex or Cursor build the API integration into your product, tool or pipeline The Runway Dev MCP and skills, and an API key for live calls How do you get API access to Seedream 5.5 Layers?

You get API access to Seedream 5.5 Layers with a Runway Dev account and an API key: Create an account at https://dev.runway.com . Create an API key in your project’s dashboard. Add credits to your project’s balance. Store the key in your environment as RUNWAYML_API_SECRET . Send a request with "model": "seedream5.5_layers" , one image in referenceImages and the X-Runway-Version header to POST /v1/text_to_image . The code below is ready to run.

How much does the Seedream 5.5 Layers API cost? The Seedream 5.5 Layers API on Runway Dev is billed per image it returns, counting the base image and each layer: 2 credits ($0.02) per image at 1K or 2 credits ($0.02) per image at 1.5K, and 4 credits ($0.04) per image at 2K or with auto . Option Credits USD auto 4 credits per image $0.04 per image 1K 2 credits per image $0.02 per image 1.5K 2 credits per image $0.02 per image 2K 4 credits per image $0.04 per image The source image, once per request: +0.8 credits ($0.008).

Billed for the base image and each layer returned. Charged up front for the image cap you set, then refunded for any not returned. Each request is rounded up to a whole credit. Prices current as of November 19, 2026. 1 credit = $0.01. How the billing works: You pay for the images the task returns. A split into a base image and eight layers is billed for nine images, plus the charge for the source image listed under the table.

Credits are reserved up front for maxImages , then settled. A task holds credits for the most images it may return, and the images it doesn’t return are refunded when it finishes. A lower maxImages reserves less. resolution sets the rate. auto , the default, sizes the output from your image and bills at the largest size’s rate. Send a smaller resolution for the lower rate. A task that fails input moderation ( SAFETY.INPUT.* ) is still charged.

See task failures for what each failure means. Every rate is also listed in the docs pricing guide and on Runway Dev pricing . What does the Seedream 5.5 Layers API return? A Seedream 5.5 Layers task returns a base image and a set of layers, all as separate files. The base image is the scene with the separated objects removed and the area behind them filled in. Each layer is one object as a PNG with a transparent background, cropped to that object.

Here are the layers from the kitchen above, laid on a checkerboard that marks the transparent pixels: The completed task carries the files in two fields: output lists a URL for every image, the base image included. layers describes the same images, in the same order. Each entry has the image’s uri , a name , a zIndex and, for a layer, a boundingBox . { "status" : "SUCCEEDED" , "output" : [ "https://…/layer-19.png" , "…" , "https://…/base.png" ], "layers" : [ { "uri" : "https://…/layer-19.png" , "name" : "Layer 19" , "zIndex" : 19 , "boundingBox" : { "absolute" : [ 2274 , 430 , 2530 , 695 ], "normalized" : [ 888 , 299 , 988 , 483 ] } }, { "uri" : "https://…/base.png" , "name" : "Base image" , "zIndex" : 0 } ] } What each field tells you: zIndex is the stacking order.

The base image is 0 , and a higher number sits in front. Sort by zIndex rather than by position in the list: the base image can come last. boundingBox.absolute places the layer in pixels of the base image, as left, top, right and bottom edges. boundingBox.normalized gives the same box in thousandths of the image’s width and height, for a canvas of any size. name labels each image. With no prompt, layers are numbered.

With a prompt, each one is named after what it holds, such as “Stainless steel double-door refrigerator”. The base image follows outputFormat , PNG by default or JPEG. Layers are always PNG , so their transparency survives. The refrigerator layer as the API returned it keeps its alpha channel, so you can open it in any editor and check the transparency yourself. What inputs does Seedream 5.5 Layers accept? Seedream 5.5 Layers accepts one image in referenceImages and an optional prompt, on POST /v1/text_to_image .

The image is the picture to split, and it has to be a PNG or a JPEG within the size and shape limits in the layer input requirements . POST /v1/text_to_image Field Accepts model (required) seedream5.5_layers referenceImages (required) A list of up to 1 images resolution One of auto , 1k , 1.5k or 2k outputFormat One of png or jpeg maxImages Whole number from 2 to 100 promptText Text, 1 to 4,000 characters Images go in as an HTTPS URL, a runway:// URI from an upload or a data URI; inputs lists sizes and formats.

Each table shows what a field accepts on its own. Rules that combine fields are checked when the task is submitted, and the API reference has them in full. What each optional field changes: promptText names the elements to separate. Left out, the model decides for itself. The next section shows the difference. maxImages caps how many images the task returns , the base image included, and with it the credits reserved up front. resolution sets the output size. auto , the default, sizes it from your image, and the inputs table lists the other values. outputFormat sets the base image’s format: png , the default, or jpeg .

How do you choose which elements become layers with the Seedream 5.5 Layers API? You choose the elements that become layers on Seedream 5.5 Layers by naming them in promptText . With no prompt, the model separates every element it finds, as in the kitchen above. With a prompt, it separates the ones you name and leaves the rest in the base image, which keeps the task smaller and cheaper. Set maxImages to the number of layers you expect plus the base image, so the task reserves only what it needs.

This request separates only the stools and the refrigerator from the same kitchen: { "model" : "seedream5.5_layers" , "referenceImages" : [ { "uri" : "https://d3phaj0sisr2ct.cloudfront.net/devportal/learn/images/seedream-5-5-layers-api/kitchen-source-eddc18e9.jpg" } ], "promptText" : "Separate the two bar stools and the refrigerator into

The rest of this page is on the live site.