Seedream 5.0 Flash is LIVE — Faster & Cheaper | Try Now →

bytedance/seedream-v5.0-flash/layer-decomposition

Seedream V5.0 Flash Layer Decomposition separates a single image into a base image and transparent layers faster and at lower cost than Seedream V5.0 Pro, enabling flexible compositing, image editing, asset extraction, and layered design workflows at one price for 1K / 1.5K / 2K. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

image-to-image
Input
Enable Safety Checker

Idle

$0.459per run·~21 / $10

Next:

ExamplesView all

Related Models

README

Seedream V5.0 Flash Layer Decomposition

Seedream V5.0 Flash Layer Decomposition separates a single input image into a base image and transparent image layers for compositing, design, and editing workflows. It shares Seedream V5.0 Pro Layer Decomposition's capability and returns layers faster at a lower price.

Why Choose This?

  • Layered image decomposition
    Separate one image into a base image and up to 16 transparent layers.

  • Editing-ready outputs
    Use decomposed layers for compositing, retouching, layout design, and creative editing.

  • Prompt-guided layer control
    Optionally describe the desired layers, targets, objects, or grouping behavior.

  • Automatic element detection
    When no prompt is provided, the model identifies key visual elements automatically.

  • One price for every resolution
    1k, 1.5k, and 2k all cost the same.

Parameters

ParameterRequiredDescription
imageYesThe image to decompose into layers. Supports PNG and JPEG images.
promptNoOptional positive prompt describing the desired layers, targets, objects, or grouping behavior.
resolutionNoOutput resolution tier: 1k, 1.5k, or 2k.
output_formatNoOutput image format: jpeg or png. Use png to keep layer transparency.

How to Use

  1. Upload an image — Provide a single PNG or JPEG image for decomposition.
  2. Add a prompt optional — Describe the objects, groups, targets, or layer structure you want.
  3. Choose resolution1k, 1.5k, or 2k; the price is the same.
  4. Choose output format — Select png for transparent layers, or jpeg.
  5. Submit — Generate the base image and layers.

Pricing

A flat $0.459 per request at every resolution.

ResolutionPrice
1k$0.459
1.5k$0.459
2k$0.459

Best Use Cases

  • Compositing workflows — Separate foreground objects and background elements for layered editing.
  • Design production — Convert flat images into editable visual components.
  • Marketing asset preparation — Extract reusable objects, products, or scene elements from campaign images.
  • Creative editing — Rearrange, restyle, replace, or refine isolated image layers.
  • High-volume layer extraction — Process large image sets where speed and cost matter.

Pro Tips

  • Use a clear image with distinct foreground, subject, and background regions.
  • Add a prompt when you need specific objects, groupings, or a fixed number of layers.
  • Use png output when you need the layers' transparent backgrounds.
  • Since every resolution costs the same, pick 2k when you need higher-resolution layers.
  • Avoid cluttered scenes when you need precise layer separation.

Related Models

Note:This website uses AI models provided by third parties. Documentation prices are for reference and may be outdated. The Generate button shows an estimate; the final task charge prevails.

Seedream v5.0 Flash Layer Decomposition API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/bytedance/seedream-v5.0-flash/layer-decomposition with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read output values from data.outputs. Examples for Seedream v5.0 Flash Layer Decomposition below.

HTTP example
set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
    "resolution": "1k",
    "output_format": "jpeg"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/bytedance/seedream-v5.0-flash/layer-decomposition" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d "$REQUEST_BODY")

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done
Node.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/bytedance/seedream-v5.0-flash/layer-decomposition";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
        "resolution": "1k",
        "output_format": "jpeg"
}),
});
const task = body.data ?? body;
if (!task.id) throw new Error("Submission response did not contain a prediction id");
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
  await new Promise(resolve => setTimeout(resolve, 2000));
}
Python example
import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
    "resolution": "1k",
    "output_format": "jpeg"
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/bytedance/seedream-v5.0-flash/layer-decomposition", json.dumps(payload).encode())
task = body.get("data", body)
if not task.get("id"):
    raise RuntimeError("Submission response did not contain a prediction id")
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout", "deleted"}:
        raise RuntimeError(result)
    time.sleep(2)

Seedream v5.0 Flash Layer Decomposition API — Frequently asked questions

What is the Seedream v5.0 Flash Layer Decomposition API?

Seedream v5.0 Flash Layer Decomposition is a ByteDance model for image editing, exposed as a REST API on WaveSpeedAI. Seedream V5.0 Flash Layer Decomposition separates a single image into a base image and transparent layers faster and at lower cost than Seedream V5.0 Pro, enabling flexible compositing, image editing, asset extraction, and layered design workflows at one price for 1K / 1.5K / 2K. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Seedream v5.0 Flash Layer Decomposition API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates Python, JavaScript, and cURL examples for submitting requests and polling results. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/bytedance/bytedance-seedream-v5.0-flash-layer-decomposition.

How much does Seedream v5.0 Flash Layer Decomposition cost per run?

Seedream v5.0 Flash Layer Decomposition starts at $0.459 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Seedream v5.0 Flash Layer Decomposition accept?

Key inputs: `prompt`, `image`, `resolution`, `output_format`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/bytedance/bytedance-seedream-v5.0-flash-layer-decomposition.

How do I get started with the Seedream v5.0 Flash Layer Decomposition API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Seedream v5.0 Flash Layer Decomposition outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (ByteDance). Check the provider's applicable terms and WaveSpeedAI's Terms of Service before commercial use.

llms.txtbytedance/seedream-v5.0-flash/layer-decomposition for AI agents and LLMs
Seedream V5.0 Flash Layer Decomposition API on WaveSpeedAI