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
Parameters
| Name | Type | Default | Constraints | Description |
|---|---|---|---|---|
| image *Image | image_upload | — | image/* · 1–1 items | The image to decompose into layers. |
| promptPrompt | textarea | — | ≤ 5000 chars | The positive prompt for the generation. |
| output_formatOutput Format | select | png | jpeg | png | The format of the output image. |
| sizeSize | select | auto | 1K | 1.5K | 2K | auto |
Output fields
| Field | Type | Description |
|---|---|---|
| images | array<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
| Parameter | Required | Default / limits |
|---|---|---|
image | Yes | 1 image URL |
prompt | No | 5000 characters |
output_format | No | png; jpeg, png |
size | No | auto; 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.
Related models
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.
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.
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.
OpenAI GPT Image 2.5 Sunburst Edit
High-fidelity image editing for precise transformations using up to 16 reference images.
OpenAI GPT Image 2.5 Flare Edit
Fast, balanced image editing from natural-language instructions and up to 16 reference images.
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.
Nano Banana Image Edit
Fast & Affordable Editing. Intuitive object replacement and style transfer without manual masking.
Nano Banana Pro Image Edit
4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.