> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Seedream 5.5 Layer Decomposition
> > 🚧 **This model is not yet available, stay tuned**
- Seedream 5.5 Layer Decomposition (doubao-seedream-5.5-layerize) separates an image into a base image and independent layers
- Provide `1` input image. `prompt` is optional; when omitted, the model automatically identifies and separates the main elements
- Use `n` to set the maximum output count and `model_params.text_recognition` to enable text recognition
- Processing is asynchronous. Use the returned task ID to [query task status](/en/api-manual/task-management/get-task-detail)
- Generated image links are valid for 24 hours, please save them promptly
### Output details
- `output_format` sets the base image format. Independent layers are always PNG images with an alpha channel
- Each image in `result_data` includes `z_index` (stacking order: `0` for the base image, increasing from `1` for layers) and `background` (`opaque` for the base image, `transparent` for layers). Layers also include `bounding_box` (`absolute` uses pixel coordinates in the base-image coordinate system; `normalized` ranges from `0` to `1000`), `name` and `description`
- If any layer fails, the entire task fails with a full refund. Partial results are not returned
### Billing
- The base image and each layer are billed individually. The input image is charged separately
- Task creation reserves credits for `1` input image and up to `n` output images. On completion, billing is settled against the actual output count and unused credits are returned automatically
## OpenAPI
````yaml en/api-manual/image-series/seedream-5.5/seedream-5.5-layerize-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
title: doubao-seedream-5.5-layerize Interface
description: >-
Use the Seedream 5.5 layer decomposition model to split one image into a
base image and multiple editable layers
license:
name: MIT
version: 1.0.0
servers:
- url: https://api.evolink.ai
description: Production environment
security:
- bearerAuth: []
tags:
- name: Image Generation
description: AI image generation related APIs
paths:
/v1/images/generations:
post:
tags:
- Image Generation
summary: doubao-seedream-5.5-layerize Interface
description: >-
> 🚧 **This model is not yet available, stay tuned**
- Seedream 5.5 Layer Decomposition (doubao-seedream-5.5-layerize)
separates an image into a base image and independent layers
- Provide `1` input image. `prompt` is optional; when omitted, the model
automatically identifies and separates the main elements
- Use `n` to set the maximum output count and
`model_params.text_recognition` to enable text recognition
- Processing is asynchronous. Use the returned task ID to [query task
status](/en/api-manual/task-management/get-task-detail)
- Generated image links are valid for 24 hours, please save them
promptly
### Output details
- `output_format` sets the base image format. Independent layers are
always PNG images with an alpha channel
- Each image in `result_data` includes `z_index` (stacking order: `0`
for the base image, increasing from `1` for layers) and `background`
(`opaque` for the base image, `transparent` for layers). Layers also
include `bounding_box` (`absolute` uses pixel coordinates in the
base-image coordinate system; `normalized` ranges from `0` to `1000`),
`name` and `description`
- If any layer fails, the entire task fails with a full refund. Partial
results are not returned
### Billing
- The base image and each layer are billed individually. The input image
is charged separately
- Task creation reserves credits for `1` input image and up to `n`
output images. On completion, billing is settled against the actual
output count and unused credits are returned automatically
operationId: createSeedreamLayerizeImageGeneration
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ImageGenerationRequest'
examples:
auto_layerize:
summary: Automatic decomposition (without prompt) with text recognition
value:
model: doubao-seedream-5.5-layerize
image_urls:
- https://example.com/poster.png
quality: auto
output_format: png
'n': 30
model_params:
text_recognition: true
prompt_layerize:
summary: Specify elements in natural language
value:
model: doubao-seedream-5.5-layerize
prompt: Split out the parrot and the title text
image_urls:
- https://example.com/poster.png
quality: 2K
bbox_layerize:
summary: Specify with bbox coordinates
value:
model: doubao-seedream-5.5-layerize
prompt: >-
title text179 58 809 197, 1 parrot330 274
641 991
image_urls:
- https://example.com/poster.png
quality: 1.5K
responses:
'200':
description: Image generation task created successfully
content:
application/json:
schema:
$ref: '#/components/schemas/ImageGenerationResponse'
'400':
description: Invalid request parameters
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: invalid_request
message: Invalid request parameters
type: invalid_request_error
'401':
description: Unauthenticated, invalid or expired token
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: unauthorized
message: Invalid or expired token
type: authentication_error
'402':
description: Insufficient quota, recharge required
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: insufficient_quota
message: Insufficient quota. Please top up your account.
type: insufficient_quota
'403':
description: Access denied
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: model_access_denied
message: >-
Token does not have access to model:
doubao-seedream-5.5-layerize
type: invalid_request_error
'429':
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: rate_limit_exceeded
message: Too many requests, please try again later
type: rate_limit_error
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: internal_error
message: Internal server error
type: api_error
components:
schemas:
ImageGenerationRequest:
type: object
required:
- model
- image_urls
properties:
model:
type: string
description: Image generation model name
enum:
- doubao-seedream-5.5-layerize
default: doubao-seedream-5.5-layerize
example: doubao-seedream-5.5-layerize
image_urls:
type: array
description: >-
URL of the image to decompose (required)
**Note:**
- **Exactly `1` image is required**; omitting it or passing `2` or
more returns an error
- Supported formats: `.png`, `.jpeg`, `.jpg` (stricter than plain
generation — webp and others are rejected)
- Image size: no more than `30MB`
- Total pixels: `[262144, 6000×6000]`, i.e. at least `512×512` (a
higher lower bound than plain generation)
- Aspect ratio (width/height) range: `[1/16, 16]`
- The image URL must be directly viewable by the server, or the URL
must trigger a direct download when accessed (usually such URLs end
with an image file extension, such as `.png`, `.jpg`)
- The input image is charged separately
items:
type: string
format: uri
minItems: 1
maxItems: 1
example:
- https://example.com/poster.png
prompt:
type: string
description: >-
Which elements to split out (optional)
**Three ways to use it:**
- **Omit it**: the model detects every major element in the image
and splits them one by one
- **Natural language**: e.g. `Split out the parrot and the title
text` — elements are identified semantically and turned into layers
- **Exact coordinates**: use `` tags to pin down a position,
e.g. `title text179 58 809 197`; normalized coordinates
(`0`~`1000`) are recommended
example: Split out the parrot and the title text
'n':
type: integer
description: >-
Maximum number of output images, including the base image. Defaults
to `30`.
**Details:**
- Allowed range: `2` to `100`. Values outside this range return
`400` with no charge
- Decomposition stops at this limit; remaining elements may be
merged or omitted. A larger value allows finer separation
- A larger `n` reserves more credits. On completion, billing is
settled against the actual output count and unused credits are
returned automatically
minimum: 2
maximum: 100
default: 30
example: 30
quality:
type: string
description: >-
Output resolution. Defaults to `auto`.
**Options:** `auto`, `1K`, `1.5K`, `2K`
**Notes:**
- Only the resolution options above are supported. Passing an aspect
ratio (such as `16:9`) or pixel dimensions (such as `2048x2048`)
returns an error
- `auto` makes the output follow the input image: if the original
size falls within `[921600, 4624220]` pixels it is kept as is, below
1K it is output at 1K, above 2K it is output at 2K
- Each layer keeps its own aspect ratio from the original image, and
the base image keeps the aspect ratio of the input
enum:
- auto
- 1K
- 1.5K
- 2K
default: auto
example: auto
prompt_priority:
type: string
description: >-
Prompt optimization mode. Only `standard` is supported and is the
default.
Passing `fast` returns `400` with no charge.
enum:
- standard
default: standard
example: standard
output_format:
type: string
description: >-
Output image format
**Options:**
- `png`: PNG format (default)
- `jpeg`: JPEG format
**Note:** This parameter **only controls the base image**. The
layers are always PNG with an alpha channel and are not affected by
it.
enum:
- png
- jpeg
default: png
example: png
model_params:
type: object
description: >-
Additional options for layer decomposition. Only `text_recognition`
is accepted; other keys return `400`.
properties:
text_recognition:
type: boolean
description: >-
Whether to recognize text in text layers
- `false`: Layers only include `name`, `description` and
`bounding_box` (default)
- `true`: Layers containing regular text additionally return
`text_recognition`: the full `text` (multiple lines joined by
`\n`, ordered top to bottom, then left to right), each line’s
`bounding_box`, and each text segment’s `text` and `style`
(`similar_font_family` for a similar font, `foreground_color`
for text color, and the `bold` / `italic` / `underline` /
`strikethrough` / `shadow` / `translucent` style flags)
Artistic, handwritten and decorative text layers do not return
`text_recognition`.
default: false
example: true
callback_url:
type: string
description: >-
HTTPS callback address after task completion
**Callback Timing:**
- Triggered when task is completed, failed, or cancelled
- Sent after billing confirmation is completed
**Security Restrictions:**
- Only HTTPS protocol is supported
- Callback to internal IP addresses is prohibited (127.0.0.1,
10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
- URL length must not exceed `2048` characters
**Callback Mechanism:**
- Timeout: `10` seconds
- Maximum `3` retries on failure (retries after `1` second/`2`
seconds/`4` seconds)
- Callback response body format is consistent with the task query
API response format
- Callback address returning 2xx status code is considered
successful, other status codes will trigger retry
format: uri
example: https://your-domain.com/webhooks/image-task-completed
ImageGenerationResponse:
type: object
properties:
created:
type: integer
description: Task creation timestamp
example: 1757165031
id:
type: string
description: Task ID
example: task-unified-1793612934-seedream55layerize
model:
type: string
description: Actual model name used
example: doubao-seedream-5.5-layerize
object:
type: string
enum:
- image.generation.task
description: Specific task type
progress:
type: integer
description: Task progress percentage (0-100)
minimum: 0
maximum: 100
example: 0
status:
type: string
description: Task status
enum:
- pending
- processing
- completed
- failed
example: pending
task_info:
$ref: '#/components/schemas/TaskInfo'
description: Async task information
type:
type: string
enum:
- text
- image
- audio
- video
description: Task output type
example: image
usage:
$ref: '#/components/schemas/Usage'
description: Usage and billing information
ErrorResponse:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Error code identifier
message:
type: string
description: Error description
type:
type: string
description: Error type
TaskInfo:
type: object
properties:
can_cancel:
type: boolean
description: Whether the task can be cancelled
example: true
estimated_time:
type: integer
description: Estimated completion time (seconds)
minimum: 0
example: 150
Usage:
type: object
description: Usage and billing information
properties:
billing_rule:
type: string
description: Billing rule
enum:
- per_call
- per_image
- per_token
- per_second
example: per_image
credits_reserved:
type: number
description: Estimated credits consumed
minimum: 0
example: 55.624
user_group:
type: string
description: User group category
example: default
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
##All APIs require Bearer Token authentication##
**Get API Key:**
Visit [API Key Management Page](https://evolink.ai/dashboard/keys) to
get your API Key
**Add to request header:**
```
Authorization: Bearer YOUR_API_KEY
```
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.