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.

Examples

Seedream 5.0 Flash Layer Decomposition Examples 1

Parameters

NameTypeDefaultConstraintsDescription
image *Imageimage_upload—image/* · 1–1 itemsThe image to decompose into layers.
promptPrompttextarea—≤ 5000 charsThe positive prompt for the generation.
output_formatOutput Formatselectpngjpeg | pngThe format of the output image.
sizeSizeselectauto1K | 1.5K | 2K | auto

Output fields

FieldTypeDescription
imagesarray<string>Generated image URLs.

API

Call this model through one unified REST API. Get a key on the API Keys page.

cURL
# 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"
Python
import time, requests

API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1) Submit
resp = requests.post(
    "https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-flash/layer-decomposition",
    headers=HEADERS,
    json={
        "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"
        }
    },
)
resp.raise_for_status()  # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()

# 2) Poll until a terminal state (completed / failed / cancelled).
#    This model is allowed up to 300s server-side.
deadline = time.time() + 360
while task.get("status") not in ("completed", "failed", "cancelled"):
    if time.time() > deadline:
        raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
    time.sleep(3)
    poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
    poll.raise_for_status()
    task = poll.json()

print(task["status"], task.get("output"))
JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };

// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-flash/layer-decomposition", {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    "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"
    }
  }),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();

// 2) Poll until a terminal state (completed / failed / cancelled).
//    This model is allowed up to 300s server-side.
const deadline = Date.now() + 360 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
  if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
  await new Promise((r) => setTimeout(r, 3000));
  const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
  if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
  task = await poll.json();
}

console.log(task.status, task.output);

Documentation

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"

Response

Submission returns task_uuid and status. Poll with the same API key until completed or failed. Successful image URLs are in output.images; cost_credits is in credits and may reflect the precharge until settlement finishes. Use your own accessible input image URL for editing or decomposition. The example URL below is from the MaaS public model example.

BytePlus official pricing · Official image API

Related models

xAI Grok Imagine Image v2.0 Edit
Image to ImageX Ai

xAI Grok Imagine Image v2.0 Edit

xAI Grok Imagine Image V2.0 Edit transforms input images with text prompts, with configurable resolution and quality for precise image editing, visual refinements, creative variations, social content, marketing assets, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.090 / per run
qwen-image-edit-spicy
Image to Image

qwen-image-edit-spicy

Precisely edit images with text instructions. Add, remove, or modify visual elements, transfer styles, and replace backgrounds for photo retouching and visual design.

from $0.040 / per run
Qwen Image 3.0 Pro Edit | Fast Image Editing
Image to ImageQwen Image 3.0 Pro

Qwen Image 3.0 Pro Edit | Fast Image Editing

Qwen Image 3.0 Pro Edit is a professional-grade image editing model with superior quality and advanced instruction understanding. Up to 2k. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.078 / per run
OpenAI GPT Image 2.5 Sunburst Edit
Image to ImageOpenAI

OpenAI GPT Image 2.5 Sunburst Edit

High-fidelity image editing for precise transformations using up to 16 reference images.

from $0.220 / per run
OpenAI GPT Image 2.5 Flare Edit
Image to ImageOpenAI

OpenAI GPT Image 2.5 Flare Edit

Fast, balanced image editing from natural-language instructions and up to 16 reference images.

from $0.220 / per run
Image to Image
Image to ImageNamiFusion

Head Swap (Image)

Swap the head in a photo with the head from a reference image. Upload the target photo first, then the head reference.

from $0.220 / per run
Nano Banana Image Edit
Image to ImageGoogle

Nano Banana Image Edit

Fast & Affordable Editing. Intuitive object replacement and style transfer without manual masking.

from $0.038 / per run
Nano Banana Pro Image Edit
Image to ImageGoogle

Nano Banana Pro Image Edit

4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.

from $0.140 / per run