Split one JPEG or PNG image into a base image and separate transparent PNG layers with Seedream 5.5. The request creates an asynchronous task; query the task or receive a webhook to download the layer images.
Developer API pricing
Provider: SeeAPI
USD estimate: $0.0037 / credit · Estimated equivalent, not an additional charge.
1K / 1.5K: 2 credits + 4.9 credits × max_images (≈ $0.007 + $0.018 × max_images)
2K / auto: 2 credits + 8.5 credits × max_images (≈ $0.007 + $0.032 × max_images)
Precharge amounts. Credits are reserved when the task is created. After delivery, the task is billed by actual usage and the difference is settled automatically: unused credits are refunded and any shortfall is charged.
/v1/generationsA new, stable key for each generation request. Reuse it only when retrying the same request body.
order-20260818-001The model ID shown in the selected model's API documentation.
seedream-5-5seedream-5-5seedream-5-5Layer Decomposition. Use the Endpoint ID shown in this model's API documentation.
layer-decompositionlayer-decompositionlayer-decompositionOptional public Provider ID. Omit it to use the Endpoint default Provider (seeapi).
seeapiseeapiseeapiLayer Decomposition parameters for the selected Provider. See the Provider parameters below.
Provider parameters
seeapiDefault ProviderDescribes which elements to separate into layers. Leave it empty to let the model detect the main elements automatically.
The image to decompose into layers. Pass a publicly accessible image URL.
["https://client.example.com/input.png"]Output size tier for the base image and the separated layers.
auto1K1.5K2KautoFile format of the base image. Separated layers are always returned as PNG with transparency.
pngjpegpngMaximum number of images to return, including the base image. The model decides how many layers it can separate, so a task can return fewer images than requested.
5Tries to recognize text in the image so it can be separated into its own layers.
falseEnables the content safety check for this task.
trueAn absolute HTTPS URL that receives the terminal generation Webhook.
https://client.example.com/webhooks/seeapiTask ID. Use it to query the task status and results.
task_xxxseedream-5-5layer-decompositionseeapiseeapi: SeeAPIseeapiTask status. A new task starts as processing; check the final status with Get Task Details or a webhook.
processingprocessingPublic credits reserved before provider-cost settlement. Values can include up to three decimal places.
44.5Consumed public credits, with up to three decimal places. In prepaid mode, the reserved amount is reported separately as precharge_credit.
0Refunded public credits, with up to three decimal places.
02026-08-18T10:00:00Z2026-08-18T10:00:00ZWhether this response is an idempotent replay of an earlier request.
falseTask ID. Use it to query the task status and results.
task_xxxseedream-5-5layer-decompositionseeapiseeapi: SeeAPIseeapiTask status. A new task starts as processing; check the final status with Get Task Details or a webhook.
processingprocessingPublic credits reserved before provider-cost settlement. Values can include up to three decimal places.
44.5Consumed public credits, with up to three decimal places. In prepaid mode, the reserved amount is reported separately as precharge_credit.
0Refunded public credits, with up to three decimal places.
02026-08-18T10:00:00Z2026-08-18T10:00:00ZWhether this response is an idempotent replay of an earlier request.
falseInvalid JSON, parameters, Schema, or API Policy
Invalid API Key or authentication failed
Insufficient credits
The current request is not allowed
Model, Endpoint, or task not found
Idempotency conflict or the same request is still being created
Request body is too large
Too many requests
Service temporarily unavailable
After submitting a task, use the unified query endpoint to check progress and retrieve results:
In production, pass callback_url to receive the result instead of polling frequently.
Manage the secret used to verify generation webhook signatures. Callback URLs are supplied when you create each generation.
Callback URL per generation.
const response = await fetch("https://api.seeapi.com/v1/generations", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Idempotency-Key": "order-20260818-001",
"Content-Type": "application/json"
},
body: JSON.stringify({
"model": "seedream-5-5",
"endpoint": "layer-decomposition",
"provider": "seeapi",
"input": {
"input_images": [
"https://client.example.com/input.png"
],
"resolution": "auto",
"output_format": "png",
"max_images": 5,
"text_recognition": false,
"nsfw_checker": true
},
"callback_url": "https://client.example.com/webhooks/seeapi"
})
});
const result = await response.json();{
"generation": {
"id": "task_xxx",
"model": "seedream-5-5",
"endpoint": "layer-decomposition",
"provider": "seeapi",
"status": "processing",
"precharge_credit": 44.5,
"consumed_credits": 0,
"refunded_credits": 0,
"created_at": "2026-08-18T10:00:00Z",
"updated_at": "2026-08-18T10:00:00Z"
},
"idempotent": false
}