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

> - Seedream 5.0 Pro separación en capas (doubao-seedream-5.0-pro-layerize) divide una imagen en una imagen base y varias capas independientes; cada capa es un PNG con canal alfa, mientras que el formato de la imagen base sigue a `output_format`
- Se requiere **exactamente una** imagen de entrada; `prompt` es opcional: si se omite, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa uno a uno
- El número de imágenes de salida lo determina el resultado de la separación (`1` ~ `17`) y no se puede controlar con parámetros de la solicitud; si falla cualquier capa, falla toda la solicitud: no hay éxito parcial y la solicitud fallida se reembolsa por completo
- Modo de procesamiento asíncrono, usa el ID de tarea devuelto para [consultar](/es/api-manual/task-management/get-task-detail). En el detalle de la tarea, cada elemento de `result_data` incluye `z_index` (orden de apilado: `0` para la imagen base y desde `1` en adelante para las capas); las capas incluyen además `bounding_box` (`absolute` en coordenadas de píxel de la imagen base y `normalized` en el rango `0`~`1000`), `name` y `description`
- Este modelo tarda más que una generación normal: unos `120` segundos
- Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos oportunamente



## OpenAPI

````yaml es/api-manual/image-series/seedream/seedream-5.0-pro-layerize-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: doubao-seedream-5.0-pro-layerize Interface
  description: >-
    Usa el modelo de separación en capas de Seedream 5.0 Pro 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.0-pro-layerize Interface
      description: >-
        - Seedream 5.0 Pro separación en capas
        (doubao-seedream-5.0-pro-layerize) divide una imagen en una imagen base
        y varias capas independientes; cada capa es un PNG con canal alfa,
        mientras que el formato de la imagen base sigue a `output_format`

        - Se requiere **exactamente una** imagen de entrada; `prompt` es
        opcional: si se omite, el modelo detecta automáticamente todos los
        elementos principales de la imagen y los separa uno a uno

        - El número de imágenes de salida lo determina el resultado de la
        separación (`1` ~ `17`) y no se puede controlar con parámetros de la
        solicitud; si falla cualquier capa, falla toda la solicitud: no hay
        éxito parcial y la solicitud fallida se reembolsa por completo

        - Modo de procesamiento asíncrono, usa el ID de tarea devuelto para
        [consultar](/es/api-manual/task-management/get-task-detail). En el
        detalle de la tarea, cada elemento de `result_data` incluye `z_index`
        (orden de apilado: `0` para la imagen base y desde `1` en adelante para
        las capas); las capas incluyen además `bounding_box` (`absolute` en
        coordenadas de píxel de la imagen base y `normalized` en el rango
        `0`~`1000`), `name` y `description`

        - Este modelo tarda más que una generación normal: unos `120` segundos

        - Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos
        oportunamente
      operationId: createSeedreamLayerizeImageGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageGenerationRequest'
            examples:
              auto_layerize:
                summary: Separación automática (sin prompt)
                value:
                  model: doubao-seedream-5.0-pro-layerize
                  image_urls:
                    - https://example.com/poster.png
                  quality: auto
                  output_format: jpeg
              prompt_layerize:
                summary: Indicar los elementos en lenguaje natural
                value:
                  model: doubao-seedream-5.0-pro-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.0-pro-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.0-pro-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.0-pro-layerize
          default: doubao-seedream-5.0-pro-layerize
          example: doubao-seedream-5.0-pro-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`)
          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
        quality:
          type: string
          description: >-
            Nivel de resolución de salida, valor predeterminado `auto`


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


            **Notas:**

            - El modo de capas **solo acepta niveles**; enviar una proporción
            (como `16:9`) o píxeles explícitos (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


            **Facturación:** el nivel se determina por imagen de salida según su
            propio número de píxeles; `1K` y `1.5K` cuestan lo mismo, y una
            imagen de salida con más de `2610000` píxeles se factura al nivel
            alto.
          enum:
            - auto
            - 1K
            - 1.5K
            - 2K
          default: auto
          example: auto
        prompt_priority:
          type: string
          description: >-
            Estrategia de optimización de prompt, utilizada para configurar el
            modo de optimización de prompt


            **Opciones:**

            - `standard`: Modo estándar, salida de mayor calidad, mayor tiempo
            de procesamiento

            - `fast`: Modo rápido, menor tiempo de procesamiento, calidad
            ligeramente inferior al modo estándar
          enum:
            - standard
            - fast
          default: standard
          example: standard
        output_format:
          type: string
          description: >-
            Formato de la imagen de salida


            **Opciones:**

            - `jpeg`: formato JPEG (predeterminado)

            - `png`: formato PNG


            **Nota:** este parámetro **solo controla la imagen base**. Las capas
            siempre son PNG con canal alfa y no se ven afectadas.
          enum:
            - jpeg
            - png
          default: jpeg
          example: jpeg
        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-1757165031-seedream5prolayerize
        model:
          type: string
          description: Nombre del modelo real utilizado
          example: doubao-seedream-5.0-pro-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: 120
    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_token
            - per_second
          example: per_call
        credits_reserved:
          type: number
          description: Créditos estimados consumidos (basado en la duración del audio)
          minimum: 0
          example: 39.168
        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

        ```

````