How to Use the Seedream 5.0 Pro Layer Decomposition API: image to image integration guide (2026)
Learn how to call the Seedream 5.0 Pro Layer Decomposition API on NamiFusion: parameters, pricing (from ≈$0.019126) and runnable copy-paste code — try it in the playground first.
Seedream 5.0 Pro Layer Decomposition is an image to image model by Doubao: Decompose one image into a base image and up to 16 layers. Official pricing per output: $0.0225 at up to 2.61 million pixels; $0.045 above. Each image is billed by its actual size. 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.019126 per output image.
TL;DR
· Task type: image to image, provided by Doubao
· Pricing: about $0.019126 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: 5 (see the table below)
· No platform watermark; commercial use allowed (per the Terms of Service)
What can you build with Seedream 5.0 Pro 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?
- Sign up on NamiFusion and create a key on the API Keys page (signup bonus credits can only be used on selected models).
- Submit a task with the cURL example below, passing your key as a Bearer token.
- Poll the task status with the returned task_uuid and read the output URLs when completed.
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-pro/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/eef493b64b3b.jpeg"
],
"prompt": "Decompose the image into clean, editable transparent layers with accurate object boundaries, preserving fine details and shadows where appropriate.",
"size": "1K",
"output_format": "png",
"optimize_prompt_options": "standard"
}
}'
# 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
size (size): optional, default "1K"
output_format (Output Format): optional, default "png"
optimize_prompt_options (Prompt Optimization Mode): optional, default "standard"
How do you write prompts for Seedream 5.0 Pro Layer Decomposition?
- 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").
- Concrete nouns beat stacked adjectives: "85mm portrait lens, golden-hour backlight" works far better than "very beautiful, ultra high quality".
- 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.
- 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.019126 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 Pro Layer Decomposition
Decompose one image into a base image and up to 16 layers. Official pricing per output: $0.0225 at up to 2.61 million pixels; $0.045 above. Each image is billed by its actual size.
Pricing
Matches the BytePlus official list price. Each successfully returned image is billed separately by its actual width × height, including the base image. A single response can contain both tiers. The one input image is free; USD 1 = 100 credits. Account discounts apply separately.
| Actual output pixels | USD / image | Credits / image |
|---|---|---|
| ≤ 2,610,000 | $0.0225 | 2.25 |
| > 2,610,000 | $0.045 | 4.5 |
At submission, Nami precharges 76.5 credits ($0.765), covering the maximum of 17 outputs at the higher rate (one base image and up to 16 layers). After completion it settles low-tier count × 2.25 + high-tier count × 4.5 credits and returns the unused precharge. Example: one 2K base image and five layers below the threshold cost 15.75 credits ($0.1575). The model listing starts at $0.0225 per image; the request quote is the maximum precharge. The requested size alone does not determine the final charge. Failed tasks are refunded.
Parameters
image must be an array containing exactly one accessible image URL. prompt is optional (maximum 5,000 characters). size accepts 1K, 1.5K, or 2K; Nami defaults to 1K. Use png (default) when you need transparency; JPEG cannot retain an alpha channel. optimize_prompt_options accepts standard (default) or fast. The model determines the layer count; there is no num_layers or num_images input. This endpoint does not accept auto, arbitrary pixel dimensions, separate resolution, or aspect_ratio as documented size controls.
| Parameters | Required | Default / limits |
|---|---|---|
image | Yes | 1 URL |
prompt | No | 5,000 |
size | No | 1K / 1.5K / 2K; Default: 1K |
output_format | No | jpeg / png; Default: png |
optimize_prompt_options | No | standard / fast; Default: standard |
Example
curl -X POST 'https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-pro/layer-decomposition' \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"input": {
"image": [
"https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/09/24/eef493b64b3b.jpeg"
],
"prompt": "Decompose the image into clean, editable transparent layers with accurate object boundaries, preserving fine details and shadows where appropriate.",
"size": "1K",
"output_format": "png",
"optimize_prompt_options": "standard"
}
}'
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 Pro 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.