How to Use the Seedream 5.0 Flash Layer Decomposition API: image to image integration guide (2026)

2 min · Updated 2026-07-11 · By the NamiFusion team

Learn how to call the Seedream 5.0 Flash Layer Decomposition API on NamiFusion: parameters, pricing (from ≈$0.018) and runnable copy-paste code — try it in the playground first.

Seedream 5.0 Flash Layer Decomposition is an image to image model by Doubao: Decompose one image into a base image and up to 16 layers. $0.018 per output image; maximum precharge $0.306 per request, settled by actual output count. On NamiFusion you can try it in the playground (exact quote shown before you submit), then call it through one unified REST API — about $0.018 per output image.

TL;DR

· Task type: image to image, provided by Doubao

· Pricing: about $0.018 per output image ($1 = 100 credits), pay-as-you-go

· Getting started: playground (exact quote before submit) → create an API key → one POST request

· Tunable parameters: 4 (see the table below)

· No platform watermark; commercial use allowed (per the Terms of Service)

What can you build with Seedream 5.0 Flash Layer Decomposition?

Social media visuals and covers: batch-generate on-theme images and schedule them straight away.

E-commerce and ad creatives: product scenes, banner backgrounds, and multi-variant visuals for A/B tests.

Concept art and ideation: characters, environments and style boards, iterated cheaply and fast.

Pipeline chaining: outputs feed directly into image-to-video or face swap as source material.

How do you call this API?

  1. Sign up on NamiFusion and create a key on the API Keys page (signup bonus credits can only be used on selected models).
  2. Submit a task with the cURL example below, passing your key as a Bearer token.
  3. Poll the task status with the returned task_uuid and read the output URLs when completed.
Submit a task
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-flash/layer-decomposition" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "image": [
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/09/24/89b481bb63b1.jpeg"
    ],
    "prompt": "Decompose the scene into clean transparent layers with accurate separation of the desk objects, preserving fine edges, shadows, and background details for easy compositing and editing.",
    "output_format": "png",
    "size": "auto"
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"

What parameters does it take?

image (Image): required

prompt (Prompt): optional

output_format (Output Format): optional, default "png"

size (Size): optional, default "auto"

How do you write prompts for Seedream 5.0 Flash Layer Decomposition?

  1. Subject first: lead with the actor and action, then add environment, lighting and style ("an astronaut sprinting through a neon street in the rain, cinematic, shallow depth of field").
  2. Concrete nouns beat stacked adjectives: "85mm portrait lens, golden-hour backlight" works far better than "very beautiful, ultra high quality".
  3. Change one variable per iteration: pin the seed to reproduce a result, tweak a single phrase at a time so you know what actually moved the output.
  4. State negatives positively: instead of "no blur", ask for "sharp focus, crisp details".

How much does it cost?

Pay per output image in credits: about $0.018 per output image ($1 = 100 credits). The total depends on the actual output count; the playground shows the precharge quote before submission.

Seedream 5.0 Flash Layer Decomposition

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

Decompose one image into a base image and up to 16 layers. $0.018 per output image; maximum precharge $0.306 per request, settled by actual output count.

Pricing

BytePlus official list price: $0.018 per output image = 1.8 credits per output image. Input images are free. All supported sizes have the same unit price. USD 1 = 100 credits. Account discounts, if any, apply separately.

Each request is precharged 30.6 credits ($0.306) for the maximum of 17 output images: one base image and up to 16 layers. After completion, the charge is settled at actual output image count × 1.8 credits, and the unused precharge is returned. For example, one base image plus five layers costs 10.8 credits ($0.108). The model listing shows the per-image unit price; the request preview shows the maximum precharge. Failed tasks are refunded.

Parameters

ParameterRequiredDefault / limits
imageYes1 image URL
promptNo5000 characters
output_formatNopng; jpeg, png
sizeNoauto; 1K, 1.5K, 2K, auto

For layer decomposition, size accepts only 1K, 1.5K, 2K, or auto (default). Explicit pixel dimensions are not supported for this operation. image is a required array containing exactly one image URL. prompt is optional. The model determines the layer count; there is no num_images or num_layers input.

Example

curl -X POST 'https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-flash/layer-decomposition' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "image": [
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/09/24/89b481bb63b1.jpeg"
    ],
    "prompt": "Decompose the scene into clean transparent layers with accurate separation of the desk objects, preserving fine edges, shadows, and background details for easy compositing and editing.",
    "output_format": "png",
    "size": "auto"
  }
}'
curl 'https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID' \
  -H "Authorization: Bearer $API_KEY"

FAQ

Can I try it for free first?+

Signup bonus credits can only be used on selected models, and eligibility may change. The playground shows the exact quote before submission.

Can I use the output commercially? Is there a watermark?+

Yes, outputs are yours to use commercially, and NamiFusion adds no platform watermark — subject to the Terms of Service and applicable law.

What is the content policy?+

Pornographic content, sexualized content involving a minor, unauthorized use of real people, deceptive impersonation, fraud and false endorsements are prohibited. Lawful, consensual, non-explicit adult themes may be permitted; see the Terms of Service.

How long does a Seedream 5.0 Flash Layer Decomposition task take?+

It depends on parameters — images usually take seconds, videos tens of seconds to minutes. The API returns a task_uuid for polling.

What are the resolution and duration limits?+

See the parameter table above — each model lists its available resolution and duration options there and in the playground.

How to Use the Seedream 5.0 Flash Layer Decomposition API: image to image integration guide (2026) | NamiFusion Blog