> ## 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 Lite Generación de imágenes

> - El modelo Seedream 5.0 Lite (doubao-seedream-5.0-lite) soporta modos de generación de texto a imagen, imagen a imagen, edición de imagen y otros
- Modo de procesamiento asíncrono, usa el ID de tarea devuelto para [consultar](/es/api-manual/task-management/get-task-detail)
- Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos oportunamente



## OpenAPI

````yaml es/api-manual/image-series/seedream-5.0-lite/seedream-5.0-lite-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: doubao-seedream-5.0-lite Interface
  description: >-
    Crear tareas de imagen usando modelos de IA, compatible con múltiples
    modelos y configuraciones de parámetros
  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-lite Interface
      description: >-
        - El modelo Seedream 5.0 Lite (doubao-seedream-5.0-lite) soporta modos
        de generación de texto a imagen, imagen a imagen, edición de imagen y
        otros

        - Modo de procesamiento asíncrono, usa el ID de tarea devuelto para
        [consultar](/es/api-manual/task-management/get-task-detail)

        - Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos
        oportunamente
      operationId: createImageGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageGenerationRequest'
            examples:
              without_search:
                summary: Generar sin búsqueda
                value:
                  model: doubao-seedream-5.0-lite
                  prompt: Un barco de papel en un lago tranquilo al atardecer
              web_search:
                summary: Búsqueda web
                value:
                  model: doubao-seedream-5.0-lite
                  prompt: >-
                    Las últimas tendencias de diseño arquitectónico moderno en
                    2026
                  model_params:
                    tools:
                      - type: web_search
              text_to_image:
                summary: Texto a imagen
                value:
                  model: doubao-seedream-5.0-lite
                  prompt: A serene lake reflecting the beautiful sunset
      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-lite
                  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
        - prompt
      properties:
        model:
          type: string
          description: Nombre del modelo de generación de imágenes
          enum:
            - doubao-seedream-5.0-lite
          default: doubao-seedream-5.0-lite
          example: doubao-seedream-5.0-lite
        prompt:
          type: string
          description: >-
            Prompt que describe la imagen que desea generar, o que describe cómo
            editar la imagen de entrada, limitado a 2000 tokens
          example: A serene lake reflecting the beautiful sunset
          maxLength: 2000
        'n':
          type: integer
          description: >-
            Número máximo de imágenes a generar, admite cualquier valor entero
            entre `[1,15]`


            **Nota:**

            - Para generar múltiples imágenes, incluya indicaciones como:
            "generate 2 different images" en su prompt


            - Cantidad de imágenes de referencia + cantidad final de imágenes
            generadas ≤ 15 imágenes


            - Si: cantidad de imágenes de referencia + imágenes solicitadas en
            el prompt > 15, y las imágenes solicitadas en el prompt ≤ valor del
            parámetro n, entonces imágenes generadas finales = 15 - cantidad de
            imágenes de referencia

            - Cada solicitud se pre-cobrará según el valor de `n`, el cobro real
            se basa en el número de imágenes generadas
          example: 1
        size:
          type: string
          default: auto
          description: >-
            Tamaño de la imagen generada; admite dos formatos:


            **Método 1 - Formato de proporción:**

            - `auto`, `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`,
            `16:9`, `21:9`, `9:21`

            - Junto con el parámetro `quality`, el sistema genera
            automáticamente una imagen con la proporción y resolución
            correspondientes, sin especificar los píxeles manualmente


            **Método 2 - Formato en píxeles:**

            - Ancho x alto, p. ej.: `2560x1440`, `2048x2048`, `4096x4096`

            - Rango total de píxeles: `[3686400, 16777216]`

            - Rango de relación de aspecto: `[1/16, 16]`
          example: '16:9'
        quality:
          type: string
          default: 2K
          description: >-
            Nivel de resolución, utilizado con el formato de proporción de
            `size`.


            | Proporción | 2K | 3K | 4K |

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

            | `1:1` | 2048×2048 | 3072×3072 | 4096×4096 |

            | `2:3` | 1664×2496 | 2496×3744 | 3328×4992 |

            | `3:2` | 2496×1664 | 3744×2496 | 4992×3328 |

            | `3:4` | 1728×2304 | 2592×3456 | 3520×4704 |

            | `4:3` | 2304×1728 | 3456×2592 | 4704×3520 |

            | `4:5` | 1792×2240 | 2688×3360 | 3584×4480 |

            | `5:4` | 2240×1792 | 3360×2688 | 4480×3584 |

            | `9:16` | 1600×2848 | 2304×4096 | 3040×5504 |

            | `16:9` | 2848×1600 | 4096×2304 | 5504×3040 |

            | `21:9` | 3136×1344 | 4704×2016 | 6240×2656 |

            | `9:21` | 1344×3136 | 2016×4704 | 2656×6240 |
          enum:
            - 2K
            - 3K
            - 4K
          example: 2K
        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
          enum:
            - standard
          default: standard
          example: standard
        image_urls:
          type: array
          description: >-
            Lista de URLs de imagen de referencia para funciones de imagen a
            imagen y edición de imagen


            **Nota:**

            - Una solicitud admite cantidad de imágenes de entrada: `10`
            imágenes

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

            - Formatos de archivo admitidos: `.jpeg`, `.jpg`, `.png`, `.webp`

            - Las URLs de imagen deben ser directamente visibles por el
            servidor, o la URL de imagen debe activar la descarga directa al
            acceder (generalmente estas URLs terminan con extensiones de archivo
            de imagen, como `.png`, `.jpg`)

            - Se pueden subir un máximo de `5` imágenes de personas reales
          items:
            type: string
            format: uri
          maxItems: 14
          example:
            - https://example.com/image1.png
            - https://example.com/image2.png
        model_params:
          type: object
          description: Parámetros adicionales del modelo
          properties:
            output_format:
              type: string
              default: jpeg
              description: Formato de la imagen de salida
              enum:
                - png
                - jpeg
              example: jpeg
            tools:
              type: array
              description: >-
                Herramientas de búsqueda web. Cuando está habilitado, el modelo
                buscará automáticamente en la web según el prompt, lo que
                generará costos adicionales


                La búsqueda está desactivada por defecto. Una tarea puede
                realizar varias búsquedas, facturadas por separado. El número y
                el coste total no se conocen antes de generar.
              items:
                type: object
                properties:
                  type:
                    type: string
                    enum:
                      - web_search
                    example: web_search
              example:
                - type: web_search
              default: []
        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-seedream5lite
        model:
          type: string
          description: Nombre del modelo real utilizado
          example: doubao-seedream-5.0-lite
        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: 45
    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: 1.8
        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.