> ## 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 separación en capas

> > 🚧 **Este modelo aún no está disponible, mantente atento**

- Seedream 5.5 Descomposición en capas (doubao-seedream-5.5-layerize) separa una imagen en una imagen base y varias capas independientes
- Proporciona `1` imagen de entrada. `prompt` es opcional; si se omite, el modelo identifica y separa automáticamente los elementos principales
- Usa `n` para limitar el número de imágenes de salida y `model_params.text_recognition` para activar el reconocimiento de texto
- Procesamiento asíncrono: usa el ID de tarea devuelto para [consultar su estado](/es/api-manual/task-management/get-task-detail)
- Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos oportunamente

### Detalles de salida

- `output_format` determina el formato de la imagen base. Las capas independientes siempre son PNG con canal alfa
- Cada imagen de `result_data` incluye `z_index` (orden de apilado: `0` para la imagen base, desde `1` para las capas) y `background` (`opaque` para la imagen base, `transparent` para las capas). Las capas también incluyen `bounding_box` (`absolute` usa coordenadas de píxel del sistema de la imagen base; `normalized` va de `0` a `1000`), `name` y `description`
- Si falla una capa, falla toda la tarea y se reembolsa el importe completo. No se devuelven resultados parciales

### Facturación

- La imagen base y cada capa se cobran individualmente. La imagen de entrada se cobra por separado
- Al crear la tarea se reservan créditos para `1` imagen de entrada y hasta `n` imágenes de salida. Al finalizar, se liquida el importe según el número real de imágenes de salida y los créditos no utilizados se devuelven automáticamente



## OpenAPI

````yaml es/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: >-
    Usa el modelo de separación en capas de Seedream 5.5 para dividir una imagen
    en una imagen base y varias capas editables
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Entorno de producción
security:
  - bearerAuth: []
tags:
  - name: Generación de imágenes
    description: APIs relacionadas con generación de imágenes IA
paths:
  /v1/images/generations:
    post:
      tags:
        - Generación de imágenes
      summary: doubao-seedream-5.5-layerize Interface
      description: >-
        > 🚧 **Este modelo aún no está disponible, mantente atento**


        - Seedream 5.5 Descomposición en capas (doubao-seedream-5.5-layerize)
        separa una imagen en una imagen base y varias capas independientes

        - Proporciona `1` imagen de entrada. `prompt` es opcional; si se omite,
        el modelo identifica y separa automáticamente los elementos principales

        - Usa `n` para limitar el número de imágenes de salida y
        `model_params.text_recognition` para activar el reconocimiento de texto

        - Procesamiento asíncrono: usa el ID de tarea devuelto para [consultar
        su estado](/es/api-manual/task-management/get-task-detail)

        - Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos
        oportunamente


        ### Detalles de salida


        - `output_format` determina el formato de la imagen base. Las capas
        independientes siempre son PNG con canal alfa

        - Cada imagen de `result_data` incluye `z_index` (orden de apilado: `0`
        para la imagen base, desde `1` para las capas) y `background` (`opaque`
        para la imagen base, `transparent` para las capas). Las capas también
        incluyen `bounding_box` (`absolute` usa coordenadas de píxel del sistema
        de la imagen base; `normalized` va de `0` a `1000`), `name` y
        `description`

        - Si falla una capa, falla toda la tarea y se reembolsa el importe
        completo. No se devuelven resultados parciales


        ### Facturación


        - La imagen base y cada capa se cobran individualmente. La imagen de
        entrada se cobra por separado

        - Al crear la tarea se reservan créditos para `1` imagen de entrada y
        hasta `n` imágenes de salida. Al finalizar, se liquida el importe según
        el número real de imágenes de salida y los créditos no utilizados se
        devuelven automáticamente
      operationId: createSeedreamLayerizeImageGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageGenerationRequest'
            examples:
              auto_layerize:
                summary: Separación automática (sin prompt) con reconocimiento de texto
                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: Indicar los elementos en lenguaje natural
                value:
                  model: doubao-seedream-5.5-layerize
                  prompt: Separa el loro y el texto del título
                  image_urls:
                    - https://example.com/poster.png
                  quality: 2K
              bbox_layerize:
                summary: Indicar con coordenadas bbox
                value:
                  model: doubao-seedream-5.5-layerize
                  prompt: >-
                    texto del título<bbox>179 58 809 197</bbox>, 1 loro<bbox>330
                    274 641 991</bbox>
                  image_urls:
                    - https://example.com/poster.png
                  quality: 1.5K
      responses:
        '200':
          description: Tarea de generación de imagen creada exitosamente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageGenerationResponse'
        '400':
          description: Parámetros de solicitud inválidos
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: invalid_request
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: No autenticado, token inválido o expirado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Cuota insuficiente, se requiere recarga
          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: Acceso denegado
          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: Límite de velocidad excedido
          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: Error interno del servidor
          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: Nombre del modelo de generación de imágenes
          enum:
            - doubao-seedream-5.5-layerize
          default: doubao-seedream-5.5-layerize
          example: doubao-seedream-5.5-layerize
        image_urls:
          type: array
          description: >-
            URL de la imagen que se va a separar (obligatorio)


            **Nota:**

            - **Se requiere exactamente `1` imagen**; omitirla o enviar `2` o
            más devuelve un error

            - Formatos admitidos: `.png`, `.jpeg`, `.jpg` (más estricto que la
            generación normal: webp y otros se rechazan)

            - Tamaño de imagen: no más de `30MB`

            - Total de píxeles: `[262144, 6000×6000]`, es decir, al menos
            `512×512` (límite inferior más alto que en la generación normal)

            - Relación de aspecto (ancho/alto): `[1/16, 16]`

            - La URL de la imagen debe ser directamente visible por el servidor,
            o debe activar la descarga directa al acceder (normalmente estas
            URLs terminan con una extensión de archivo de imagen, como `.png` o
            `.jpg`)

            - La imagen de entrada se cobra por separado
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 1
          example:
            - https://example.com/poster.png
        prompt:
          type: string
          description: >-
            Qué elementos separar (opcional)


            **Tres formas de usarlo:**

            - **Omitirlo**: el modelo detecta todos los elementos principales de
            la imagen y los separa uno a uno

            - **Lenguaje natural**: p. ej. `Separa el loro y el texto del
            título`; los elementos se identifican semánticamente y se convierten
            en capas

            - **Coordenadas exactas**: usa etiquetas `<bbox>` para fijar la
            posición, p. ej. `texto del título<bbox>179 58 809 197</bbox>`; se
            recomiendan coordenadas normalizadas (`0`~`1000`)
          example: Separa el loro y el texto del título
        'n':
          type: integer
          description: >-
            Número máximo de imágenes de salida, incluida la imagen base. El
            valor predeterminado es `30`.


            **Detalles:**

            - Rango permitido: de `2` a `100`. Los valores fuera del rango
            devuelven `400` sin cargo

            - La descomposición termina al alcanzar el límite; los elementos
            restantes pueden fusionarse u omitirse. Un valor mayor permite una
            separación más detallada

            - Un valor de `n` mayor reserva más créditos. Al finalizar, se
            liquida el importe según el número real de imágenes de salida y los
            créditos no utilizados se devuelven automáticamente
          minimum: 2
          maximum: 100
          default: 30
          example: 30
        quality:
          type: string
          description: >-
            Resolución de salida. El valor predeterminado es `auto`.


            **Opciones:** `auto`, `1K`, `1.5K`, `2K`


            **Notas:**

            - Solo se admiten las opciones de resolución indicadas. Enviar una
            proporción (como `16:9`) o dimensiones en píxeles (como `2048x2048`)
            devuelve un error

            - `auto` hace que la salida siga a la imagen de entrada: si el
            tamaño original está dentro de `[921600, 4624220]` píxeles se
            mantiene tal cual; por debajo de 1K se emite en 1K y por encima de
            2K en 2K

            - Cada capa conserva su propia proporción de la imagen original y la
            imagen base conserva la proporción de la entrada
          enum:
            - auto
            - 1K
            - 1.5K
            - 2K
          default: auto
          example: auto
        prompt_priority:
          type: string
          description: >-
            Modo de optimización del prompt. Solo se admite `standard`, que es
            el valor predeterminado.


            Enviar `fast` devuelve `400` sin cargo.
          enum:
            - standard
          default: standard
          example: standard
        output_format:
          type: string
          description: >-
            Formato de la imagen de salida


            **Opciones:**

            - `png`: Formato PNG (predeterminado)

            - `jpeg`: Formato JPEG


            **Nota:** este parámetro **solo controla la imagen base**. Las capas
            siempre son PNG con canal alfa y no se ven afectadas.
          enum:
            - png
            - jpeg
          default: png
          example: png
        model_params:
          type: object
          description: >-
            Opciones adicionales para la separación en capas. Solo se acepta
            `text_recognition`; otras claves devuelven `400`.
          properties:
            text_recognition:
              type: boolean
              description: >-
                Activar el reconocimiento de texto en las capas de texto


                - `false`: Las capas solo incluyen `name`, `description` y
                `bounding_box` (predeterminado)

                - `true`: Las capas con texto regular devuelven además
                `text_recognition`: el `text` completo (varias líneas unidas con
                `\n`, ordenadas de arriba abajo y luego de izquierda a derecha),
                el `bounding_box` de cada línea, y el `text` y `style` de cada
                segmento (`similar_font_family` para una fuente similar,
                `foreground_color` para el color del texto y los indicadores
                `bold` / `italic` / `underline` / `strikethrough` / `shadow` /
                `translucent`)


                Las capas con texto artístico, manuscrito o decorativo no
                devuelven `text_recognition`.
              default: false
              example: true
        callback_url:
          type: string
          description: >-
            Dirección de callback HTTPS después de completar la tarea


            **Momento del callback:**

            - Se activa cuando la tarea se completa, falla o se cancela

            - Se envía después de completar la confirmación de facturación


            **Restricciones de seguridad:**

            - Solo se admite el protocolo HTTPS

            - El callback a direcciones IP internas está prohibido (127.0.0.1,
            10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)

            - La longitud de la URL no debe exceder `2048` caracteres


            **Mecanismo de callback:**

            - Tiempo de espera: `10` segundos

            - Máximo `3` reintentos en caso de fallo (reintentos después de `1`
            segundo/`2` segundos/`4` segundos)

            - El formato del cuerpo de respuesta del callback es consistente con
            el formato de respuesta de la API de consulta de tareas

            - La dirección de callback que devuelve un código de estado 2xx se
            considera exitosa, otros códigos de estado activarán reintentos
          format: uri
          example: https://your-domain.com/webhooks/image-task-completed
    ImageGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Marca de tiempo de creación de la tarea
          example: 1757165031
        id:
          type: string
          description: ID de tarea
          example: task-unified-1793612934-seedream55layerize
        model:
          type: string
          description: Nombre del modelo real utilizado
          example: doubao-seedream-5.5-layerize
        object:
          type: string
          enum:
            - image.generation.task
          description: Tipo de tarea específico
        progress:
          type: integer
          description: Porcentaje de progreso de la tarea (0-100)
          minimum: 0
          maximum: 100
          example: 0
        status:
          type: string
          description: Estado de la tarea
          enum:
            - pending
            - processing
            - completed
            - failed
          example: pending
        task_info:
          $ref: '#/components/schemas/TaskInfo'
          description: Información de tarea asíncrona
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: Tipo de salida de la tarea
          example: image
        usage:
          $ref: '#/components/schemas/Usage'
          description: Información de uso y facturación
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Identificador del código de error
            message:
              type: string
              description: Descripción del error
            type:
              type: string
              description: Tipo de error
    TaskInfo:
      type: object
      properties:
        can_cancel:
          type: boolean
          description: Si la tarea puede ser cancelada
          example: true
        estimated_time:
          type: integer
          description: Créditos estimados
          minimum: 0
          example: 150
    Usage:
      type: object
      description: Información de uso y facturación
      properties:
        billing_rule:
          type: string
          description: Regla de facturación
          enum:
            - per_call
            - per_image
            - per_token
            - per_second
          example: per_image
        credits_reserved:
          type: number
          description: Créditos estimados consumidos (basado en la duración del audio)
          minimum: 0
          example: 55.624
        user_group:
          type: string
          description: Categoría de grupo de usuario
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##Todas las APIs requieren autenticación Bearer Token##


        **Obtener API Key:**


        Visita la [Página de gestión de API
        Key](https://evolink.ai/dashboard/keys) para obtener tu API Key


        **Agregar al encabezado de la solicitud:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

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