Skip to main content
POST

Authorizations

string
required
All endpoints require authentication using a Bearer TokenGet the API Key:Visit the API Key Management Page to get your API KeyAdd it to the request headers when using:

Body

string
required
Model nameFixed value: "seedream_v5_5_layerize"
object
required
Model parameters object
string
Callback URL after the task is completed
object
Custom metadata, returned as-is
string
required
Initiator task IDUser-defined task identifier, required

Response

string
Initiator task ID, which can be used to query results
string
Initial status, fixed as "pending"
number
Estimated credits consumed
string
Creation time (ISO format)

Query Task Result

After submitting a task, use the POST /api/openapi/query endpoint to poll the task status. Layer decomposition usually takes tens of seconds to several minutes. Please save the out_task_id and keep querying until it reaches a terminal state; do not resubmit. Once the task is completed, the output field returns the base image and the list of layers.

Query Response - Layer Output Structure

Once the task is completed, output is an array of image objects. The first item is the base image, and the rest are layers. Each item contains url and metadata:
array
Base image and layer list
number
Actual credits consumed

Query Response Example