Skip to main content
POST
cURL
This is the Seedream Image Generation API layer decomposition endpoint. Decompose single image into base image (1) + multiple layer outputs (up to 16 layers). Only Seedream 5.0 pro / flash supported. Submit async task and return id, use query endpoint to get results.
Usage: Use <bbox> coordinates in prompt to mark areas for decomposition, set layer_decomposition: true to enable layer decomposition mode.

Authorizations

TT-API-KEY
string
header
required

Get your API key from the TTAPI Dashboard.

Body

application/json

Layer Decomposition request parameters

model
enum<string>
required

Model name.

Available options:
doubao-seedream-5-0-pro-260628,
doubao-seedream-5-0-flash-260915
prompt
string
required

Text prompt, use coordinates to mark areas to decompose.

image
string
required

Image URL to decompose.

layer_decomposition
enum<boolean>
default:false
required

Enable layer decomposition mode. true=layer decomposition, decompose input image into base image and multiple layers (max 16); false=image generation mode. Only Seedream 5.0 pro/flash supports.

Available options:
true,
false
size
enum<string>
default:auto

Image size. Layer decomposition options: 1K, 1.5K, 2K, auto (default auto, keeps same as input). Pixel values not supported.

Available options:
1K,
1.5K,
2K,
auto
output_format
enum<string>
default:jpeg

Output image format. In layer decomposition scene, only controls base image format; layers always output as png.

Available options:
png,
jpeg
response_format
enum<string>
default:url

Return format.

Available options:
url,
b64_json
watermark
enum<boolean>
default:true

Whether to add watermark. true=Display "AI Generated" in bottom-right, false=Do not add.

Available options:
true,
false
Example:

false

optimize_prompt_options
object

Prompt optimization config

execution_expires_after
integer
default:172800

Task timeout threshold (seconds). Range [3600, 259200] (1-72 hours), default 172800 (48 hours)

priority
integer
default:0

Execution priority. Range [0, 9], higher value = higher priority, default 0 (FIFO)

safety_identifier
string

End user unique identifier, max 64 characters. Recommend passing a hashed string

Response

200 - application/json

Task submitted successfully

status
string
required

Task status

Example:

"PENDING_QUEUE"

message
string
required
Example:

"success"

id
string
required

Task ID

Example:

"30d9b07d-7349-4cbc-8e11-9ba302c6d165"

Last modified on October 23, 2026