> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goenhance.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedream 5.5 Layers

> Split one image into a base image plus up to 99 independently editable layers. Every layer is a transparent PNG, and each comes back with the coordinates you need to put it back together.

Pass exactly one image in `image_list`. `prompt` is optional — leave it out for an automatic split. `max_layers` caps how many layers come back (default 16). Splitting takes about two to three minutes, longer with more layers.

#### Reading the result

Each item in the result carries:

- `z_index` — 0 is the base image; layers ascend from 1
- `bounding_box.absolute` — `[left, top, right, bottom]` in the base image's pixels
- `bounding_box.normalized` — the same box on a 0-1000 scale, for any canvas size
- `name` and `description` — what the layer contains
- `background` — `opaque` for the base image, `transparent` for layers
- `text_recognition` — only with `text_recognition: true`, on clean text layers: the text, each line's box, and font styles

Sort by `z_index`, then place each layer using its bounding box to restore or recompose the artwork.

#### Pricing

Charged per request: one input image plus `max_layers + 1` output images (the base image and every layer), whatever number of layers actually comes back.

| What | Tokens | USD |
|---|---|---|
| Input image | 0.42 | $0.0084 |
| Each output image, 1K or 1.5K | 1.04 | $0.0208 |
| Each output image, 2K or auto | 1.82 | $0.0364 |

With the default `max_layers` of 16: 18.10 tokens ($0.3620) at 1K or 1.5K, and 31.36 tokens ($0.6272) at 2K or auto.

Returns an `img_uuid`; poll GET /api/v1/jobs/detail (or use `custom_callback_url`) to get the generated image.



## OpenAPI

````yaml api-reference/image-api/openapi-seedream-5-5-layers.json POST /api/v1/images/generations
openapi: 3.1.0
info:
  title: GoEnhance API - Seedream 5.5 Layers
  description: Seedream 5.5 Layers
  version: 1.0.0
servers:
  - url: https://api.goenhance.ai
security: []
paths:
  /api/v1/images/generations:
    post:
      tags:
        - ImageAPI
      summary: Seedream 5.5 Layers
      description: >-
        Split one image into a base image plus up to 99 independently editable
        layers. Every layer is a transparent PNG, and each comes back with the
        coordinates you need to put it back together.


        Pass exactly one image in `image_list`. `prompt` is optional — leave it
        out for an automatic split. `max_layers` caps how many layers come back
        (default 16). Splitting takes about two to three minutes, longer with
        more layers.


        #### Reading the result


        Each item in the result carries:


        - `z_index` — 0 is the base image; layers ascend from 1

        - `bounding_box.absolute` — `[left, top, right, bottom]` in the base
        image's pixels

        - `bounding_box.normalized` — the same box on a 0-1000 scale, for any
        canvas size

        - `name` and `description` — what the layer contains

        - `background` — `opaque` for the base image, `transparent` for layers

        - `text_recognition` — only with `text_recognition: true`, on clean text
        layers: the text, each line's box, and font styles


        Sort by `z_index`, then place each layer using its bounding box to
        restore or recompose the artwork.


        #### Pricing


        Charged per request: one input image plus `max_layers + 1` output images
        (the base image and every layer), whatever number of layers actually
        comes back.


        | What | Tokens | USD |

        |---|---|---|

        | Input image | 0.42 | $0.0084 |

        | Each output image, 1K or 1.5K | 1.04 | $0.0208 |

        | Each output image, 2K or auto | 1.82 | $0.0364 |


        With the default `max_layers` of 16: 18.10 tokens ($0.3620) at 1K or
        1.5K, and 31.36 tokens ($0.6272) at 2K or auto.


        Returns an `img_uuid`; poll GET /api/v1/jobs/detail (or use
        `custom_callback_url`) to get the generated image.
      parameters:
        - name: Authorization
          in: header
          description: ''
          required: false
          example: '{{Authorization}}'
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  enum:
                    - seedream-5-5-layers
                  description: Model name. Must be `seedream-5-5-layers`.
                prompt:
                  type: string
                  minLength: 1
                  maxLength: 4000
                  description: >-
                    Optional. Leave it out and the model finds and splits the
                    main elements on its own. Provide it to name the elements to
                    split, in plain language or with `<bbox>` coordinates.
                image_size:
                  type: string
                  enum:
                    - 1K
                    - 1.5K
                    - 2K
                    - auto
                  default: auto
                  description: >-
                    Output tier. `auto` follows the input image's size and is
                    billed at the 2K rate. Only tier names are accepted here —
                    pixel values such as 2048x2048 are rejected.
                image_list:
                  type: array
                  items:
                    type: object
                    properties:
                      url:
                        type: string
                        format: uri
                    required:
                      - url
                  description: >-
                    The single image to split. Exactly one image is required:
                    png or jpeg, up to 30MB, and at least 512x512 pixels in
                    total.
                  minItems: 1
                  maxItems: 1
                output_format:
                  type: string
                  enum:
                    - png
                    - jpeg
                  default: jpeg
                  description: >-
                    Output file format. This only affects the base image — every
                    layer is always a transparent png.
                max_layers:
                  type: integer
                  minimum: 1
                  maximum: 99
                  default: 16
                  description: >-
                    Maximum number of layers, not counting the base image. The
                    request is billed as `max_layers + 1` output images, so a
                    lower value costs less. Elements beyond the limit may be
                    merged or dropped.
                text_recognition:
                  type: boolean
                  default: false
                  description: >-
                    Set to true to get the recognized text, line boxes and font
                    styles for clean text layers. Stylized or handwritten text
                    is not recognized. Free.
                custom_callback_url:
                  type: string
                  format: uri
                  description: >-
                    Optional. A publicly accessible HTTPS URL. When the task
                    status changes (processing / success / failed), GoEnhance
                    sends a POST request to this URL. The request body is
                    identical to the response of GET /api/v1/jobs/detail. If
                    your server does not respond with HTTP 200, the notification
                    is retried up to 3 times, with a 3-second timeout per
                    attempt.
                  example: https://your-server.com/goenhance/callback
              required:
                - model
                - image_list
            example:
              model: seedream-5-5-layers
              prompt: Split out the title text and the product
              image_size: auto
              max_layers: 16
              text_recognition: true
              image_list:
                - url: https://your-cdn.com/poster.jpg
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                  data:
                    type: object
                    properties:
                      img_uuid:
                        type: string
                      cost:
                        type: number
                        description: >-
                          Tokens deducted for this request. This is the amount
                          actually charged, so it already reflects any discount
                          active on your account and can be lower than the
                          listed price. Tokens are deducted when the task is
                          accepted, and refunded automatically if the generation
                          ends in failure.
                        example: 31.36
                    required:
                      - img_uuid
                      - cost
                required:
                  - code
                  - msg
                  - data
              examples:
                '1':
                  summary: Success
                  value:
                    code: 0
                    msg: Success
                    data:
                      img_uuid: c12b656c-747a-44fd-9c80-add79b0c52d5
                      cost: 31.36
                '2':
                  summary: Insufficient tokens
                  value:
                    code: 100
                    msg: tokens is not enough
                quota:
                  summary: API key quota exceeded
                  value:
                    code: 101
                    msg: 'API key quota exceeded: 4990 of 5000 tokens used (monthly)'
          headers: {}
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                required:
                  - code
                  - msg
          headers: {}
      deprecated: false
      security: []

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.