> ## 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.

# Veo3.1-Lite Generación de video

> - Veo 3.1 Lite es el nivel económico de Veo 3.1: texto a video e imagen a video con primer fotograma / primer y último fotograma; sin imágenes de referencia ni `4k`
- Se factura por segundo de video generado; la tarifa depende de la resolución y de si se genera audio, consulta [precios de modelos de EvoLink](https://evolink.ai/veo-3-1?model=veo-3.1-lite-generate-preview)
- Procesamiento asíncrono: usa el ID de tarea devuelto para [consultar su estado](/es/api-manual/task-management/get-task-detail)
- Los enlaces de video generados son válidos durante 24 horas, guárdelos de inmediato



## OpenAPI

````yaml es/api-manual/video-series/veo3.1/veo-3.1-lite-generate-preview-generate.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: Veo-3.1-Lite-Generate-Preview API
  description: >-
    Crear tareas de generación de video con Veo 3.1 Lite, compatible con texto a
    video, imagen a video de primer fotograma y de primer y último fotograma
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Generación de video
    description: APIs de generación de video con IA
paths:
  /v1/videos/generations:
    post:
      tags:
        - Generación de video
      summary: Veo-3.1-Lite-Generate-Preview API
      description: >-
        - Veo 3.1 Lite es el nivel económico de Veo 3.1: texto a video e imagen
        a video con primer fotograma / primer y último fotograma; sin imágenes
        de referencia ni `4k`

        - Se factura por segundo de video generado; la tarifa depende de la
        resolución y de si se genera audio, consulta [precios de modelos de
        EvoLink](https://evolink.ai/veo-3-1?model=veo-3.1-lite-generate-preview)

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

        - Los enlaces de video generados son válidos durante 24 horas, guárdelos
        de inmediato
      operationId: createVideoGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoGenerationRequest'
            examples:
              text_to_video:
                summary: Texto a Video
                value:
                  model: veo-3.1-lite-generate-preview
                  prompt: >-
                    A golden retriever puppy running through a sunlit meadow,
                    slow motion, cinematic lighting
              first_and_last_frames:
                summary: Imagen a video de primer y último fotograma
                value:
                  model: veo-3.1-lite-generate-preview
                  prompt: >-
                    A time-lapse transition from sunrise to sunset over a
                    mountain lake
                  image_urls:
                    - https://example.com/first-frame.jpg
                    - https://example.com/last-frame.jpg
                  generation_type: FIRST&LAST
                  quality: 1080p
                  duration: 8
                  callback_url: https://your-domain.com/webhooks/video-task-completed
      responses:
        '200':
          description: Tarea de generación de video creada exitosamente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoGenerationResponse'
        '400':
          description: Parámetros de solicitud inválidos
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: invalid_parameter
                  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:
                    veo-3.1-lite-generate-preview
                  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:
    VideoGenerationRequest:
      type: object
      required:
        - model
        - prompt
      properties:
        model:
          type: string
          description: >-
            Nombre del modelo de generación de video. Este modelo no acepta
            `image_start`, `image_end` ni `model_params` (devuelve `400`)
          enum:
            - veo-3.1-lite-generate-preview
          default: veo-3.1-lite-generate-preview
          example: veo-3.1-lite-generate-preview
        prompt:
          type: string
          description: >-
            Prompt que describe el video, hasta `2000` tokens. Se cuentan con
            cl100k; los tokens no son caracteres. Google indica el inglés como
            idioma de prompt compatible. EvoLink no rechaza solicitudes por el
            idioma del prompt; no se garantizan resultados en otros idiomas.
          example: >-
            A golden retriever puppy running through a sunlit meadow, slow
            motion, cinematic lighting
        image_urls:
          type: array
          description: >-
            URLs de las imágenes de entrada para imagen a video


            **Notas:**

            - Máximo `2` imágenes por solicitud: `1` imagen se usa como primer
            fotograma, `2` imágenes se usan como primer y último fotograma

            - Tamaño de imagen: no mayor de `10 MB`

            - Formatos de archivo admitidos: `.jpg`, `.jpeg`, `.png`
          items:
            type: string
            format: uri
          maxItems: 2
          example:
            - https://example.com/first-frame.jpg
        generation_type:
          type: string
          description: >-
            Modo de generación. Si se omite, se deduce del número de imágenes:

            - `TEXT`: Texto a video (las imágenes enviadas no se usan)

            - `FIRST&LAST`: Primer y último fotograma, 1-2 imágenes


            Este modelo no admite `REFERENCE` (imagen de referencia); devuelve
            `400`
          enum:
            - TEXT
            - FIRST&LAST
        aspect_ratio:
          type: string
          description: >-
            Relación de aspecto del video. `auto` equivale a omitir
            `aspect_ratio`: no se especifica ninguna proporción y el modelo
            decide
          enum:
            - auto
            - '16:9'
            - '9:16'
        generate_audio:
          type: boolean
          description: >-
            Generar audio, por defecto `true`. Generar audio aumenta el precio
            por segundo
          default: true
        duration:
          type: integer
          description: >-
            Duración del video en segundos, por defecto `4`. Los videos más
            largos cuestan más
          enum:
            - 4
            - 6
            - 8
          default: 4
        'n':
          type: integer
          description: >-
            Número de videos a generar, por defecto `1`. Cada video se factura
            por separado
          minimum: 1
          maximum: 4
          default: 1
        quality:
          type: string
          description: >-
            Resolución de salida, por defecto `720p`. `1080p` tiene un precio
            por segundo mayor; este modelo no admite `4k`
          enum:
            - 720p
            - 1080p
          default: 720p
        seed:
          type: integer
          description: Semilla aleatoria para reproducir los resultados de generación
          minimum: 1
          maximum: 4294967295
        negative_prompt:
          type: string
          description: >-
            Prompt negativo que describe el contenido que no debe aparecer en el
            video
        person_generation:
          type: string
          description: >-
            Control de generación de personas. Si se omite, se usa el valor
            predeterminado del proveedor `allow_adult`. `allow_adult`: permitir
            solo adultos; `dont_allow`: no generar videos que contengan personas
            o rostros
          enum:
            - allow_adult
            - dont_allow
        resize_mode:
          type: string
          description: >-
            Modo de ajuste de imagen para imagen a video. Si se omite, se usa el
            valor predeterminado del proveedor `pad`. `pad`: añadir relleno para
            ajustar la relación de aspecto de salida; `crop`: recortar desde el
            centro para ajustarla. Requiere una imagen de entrada; enviar este
            parámetro sin una imagen devuelve `400`
          enum:
            - pad
            - crop
        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 o falla

            - 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` bytes UTF-8


            **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/video-task-completed
    VideoGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Marca de tiempo de creacion de la tarea
          example: 1757169743
        id:
          type: string
          description: ID de la tarea
          example: task-unified-1757169743-7cvnl5zw
        model:
          type: string
          description: Nombre del modelo realmente utilizado
          example: veo-3.1-lite-generate-preview
        object:
          type: string
          enum:
            - video.generation.task
          description: Tipo especifico de la tarea
        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: processing
        task_info:
          $ref: '#/components/schemas/VideoTaskInfo'
          description: Informacion detallada de la tarea de video
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: Tipo de salida de la tarea
          example: video
        usage:
          $ref: '#/components/schemas/VideoUsage'
          description: Informacion de uso y facturacion
    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
    VideoTaskInfo:
      type: object
      properties:
        can_cancel:
          type: boolean
          description: Si la tarea se puede cancelar
          example: false
        estimated_time:
          type: integer
          description: Tiempo estimado de finalizacion (segundos)
          minimum: 0
          example: 600
        video_duration:
          type: integer
          description: Duracion del video (segundos)
          example: 4
    VideoUsage:
      type: object
      description: Información de uso y facturación
      properties:
        billing_rule:
          type: string
          description: Regla de facturacion
          enum:
            - per_call
            - per_token
            - per_second
          example: per_call
        credits_reserved:
          type: number
          description: Creditos estimados a consumir
          minimum: 0
          example: 12.24
        user_group:
          type: string
          description: Categoria del grupo de usuarios
          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.