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

# Gemini Omni 1.2 Flash Referencia a vídeo

> - Gemini Omni 1.2 Flash (`gemini-omni-1.2-flash-reference-to-video`) genera vídeo con audio nativo a partir de imágenes, vídeos de referencia opcionales y un prompt.
- **Imágenes:** `image_urls` admite 1–10 imágenes para orientar sujetos, estilo o elementos.
- **Vídeos:** `video_urls` es opcional, hasta 3 vídeos para orientar acciones, cámara o estilo. Si `duration` supera 10 segundos, como máximo 1 vídeo de referencia.
- **Resolución:** `360p`, `720p`, `1080p` o `4k`; predeterminada `720p`.
- **Duración:** `duration` de `3` a `15` segundos enteros; predeterminada `3`.
- **Relación de aspecto:** `16:9`, `9:16` o `auto`; predeterminada `auto`.
- Audio nativo sincronizado automático, sin parámetros adicionales.
- Restricciones negativas directamente en `prompt`, como `No dialogue`; sin parámetro independiente de prompt negativo.
- Fija `seed` para mejorar la reproducibilidad.
- Procesamiento asíncrono: [consulta el estado](/es/api-manual/task-management/get-task-detail) con el ID recibido.
- Los enlaces duran 24 horas; guarda los resultados cuanto antes.



## OpenAPI

````yaml es/api-manual/video-series/gemini-omni-1.2-flash/gemini-omni-1.2-flash-reference-to-video.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: Gemini Omni 1.2 Flash Referencia a vídeo
  description: Genera vídeo con imágenes y vídeos de referencia
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Produccion
security:
  - bearerAuth: []
paths:
  /v1/videos/generations:
    post:
      tags:
        - Generacion de video
      summary: Gemini Omni 1.2 Flash Referencia a vídeo
      description: >-
        - Gemini Omni 1.2 Flash (`gemini-omni-1.2-flash-reference-to-video`)
        genera vídeo con audio nativo a partir de imágenes, vídeos de referencia
        opcionales y un prompt.

        - **Imágenes:** `image_urls` admite 1–10 imágenes para orientar sujetos,
        estilo o elementos.

        - **Vídeos:** `video_urls` es opcional, hasta 3 vídeos para orientar
        acciones, cámara o estilo. Si `duration` supera 10 segundos, como máximo
        1 vídeo de referencia.

        - **Resolución:** `360p`, `720p`, `1080p` o `4k`; predeterminada `720p`.

        - **Duración:** `duration` de `3` a `15` segundos enteros;
        predeterminada `3`.

        - **Relación de aspecto:** `16:9`, `9:16` o `auto`; predeterminada
        `auto`.

        - Audio nativo sincronizado automático, sin parámetros adicionales.

        - Restricciones negativas directamente en `prompt`, como `No dialogue`;
        sin parámetro independiente de prompt negativo.

        - Fija `seed` para mejorar la reproducibilidad.

        - Procesamiento asíncrono: [consulta el
        estado](/es/api-manual/task-management/get-task-detail) con el ID
        recibido.

        - Los enlaces duran 24 horas; guarda los resultados cuanto antes.
      operationId: createGeminiOmni12FlashReferenceToVideoGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GeminiOmni12FlashReferenceToVideoRequest'
            examples:
              reference_to_video:
                summary: Referencia a vídeo
                value:
                  model: gemini-omni-1.2-flash-reference-to-video
                  prompt: >-
                    Haz que el personaje de la imagen de referencia pasee por la
                    escena de referencia.
                  image_urls:
                    - https://example.com/character.png
                    - https://example.com/scene.png
                  quality: 720p
                  aspect_ratio: '16:9'
                  duration: 3
              reference_with_video:
                summary: Referencias de imagen y vídeo
                value:
                  model: gemini-omni-1.2-flash-reference-to-video
                  prompt: >-
                    Haz que el personaje de la imagen de referencia realice las
                    acciones del vídeo de referencia.
                  image_urls:
                    - https://example.com/character.png
                  video_urls:
                    - https://example.com/reference.mp4
                  quality: 720p
                  aspect_ratio: '16:9'
                  duration: 3
      responses:
        '200':
          description: Tarea de video creada exitosamente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoGenerationResponse'
        '400':
          description: Parametros de solicitud invalidos
          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 invalido 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:
                    gemini-omni-1.2-flash-reference-to-video
                  type: invalid_request_error
        '429':
          description: Limite 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:
    GeminiOmni12FlashReferenceToVideoRequest:
      required:
        - model
        - prompt
        - image_urls
      type: object
      additionalProperties: false
      properties:
        model:
          type: string
          description: >-
            Nombre del modelo, fijo en
            `gemini-omni-1.2-flash-reference-to-video`
          enum:
            - gemini-omni-1.2-flash-reference-to-video
          example: gemini-omni-1.2-flash-reference-to-video
          default: gemini-omni-1.2-flash-reference-to-video
        prompt:
          type: string
          description: >-
            Prompt que describe el uso de las referencias de sujeto, estilo y
            movimiento.


            Admite chino e inglés. Describe claramente las acciones y los
            cambios para obtener resultados más estables. Escribe las
            restricciones negativas directamente en `prompt`, como `No dialogue`
            o `Sin texto`; no hay un parámetro independiente de prompt negativo.


            El prompt es obligatorio y no puede estar vacío ni contener solo
            espacios en blanco.
          example: Un gatito juega dando suaves zarpazos a un ovillo de lana.
          minLength: 1
          pattern: \S
        image_urls:
          type: array
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 10
          description: >-
            Array de URL de imágenes de referencia. Obligatorio; de 1 a 10
            imágenes para restringir sujetos, estilo o elementos.


            **Requisitos de entrada:**

            - Solo URL de imagen HTTP/HTTPS

            - Formatos admitidos: `png`, `jpeg`, `webp`
          example:
            - https://example.com/character.png
            - https://example.com/scene.png
        video_urls:
          type: array
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 3
          description: >-
            Array opcional de vídeos de referencia. Hasta 3 vídeos; si
            `duration` supera `10` segundos, como máximo 1. Puede combinarse con
            `image_urls` para orientar acciones, cámara o estilo. Solo URL
            HTTP/HTTPS de vídeo en formato mp4. **Facturación:** cada vídeo
            aporta tokens de entrada según su duración.


            Cada vídeo de referencia debe durar como máximo `10` segundos.
          example:
            - https://example.com/reference.mp4
        quality:
          type: string
          description: >-
            Resolución de vídeo; valor predeterminado `720p`.


            **Valores admitidos:**

            - `360p`: horizontal 640×360 / vertical 360×640

            - `720p`: horizontal 1280×720 / vertical 720×1280; valor
            predeterminado

            - `1080p`: horizontal 1920×1080 / vertical 1080×1920

            - `4k`: horizontal 3840×2160 / vertical 2160×3840


            La orientación depende de `aspect_ratio`: `16:9` produce horizontal
            y `9:16` vertical.


            **Facturación:** Los tokens de salida aumentan linealmente con la
            resolución. Frente a `720p`, `360p` usa aproximadamente un tercio,
            `1080p` alrededor de 1,5× y `4k` alrededor de 3×. El cargo real
            depende del uso generado.
          enum:
            - 360p
            - 720p
            - 1080p
            - 4k
          default: 720p
          example: 720p
        duration:
          type: integer
          description: >-
            Duración del vídeo en segundos; predeterminada `3`. Admite enteros
            de `3` a `15`. La duración afecta directamente a la facturación.
          minimum: 3
          maximum: 15
          default: 3
          example: 3
        aspect_ratio:
          type: string
          description: 'Relación de aspecto: 16:9, 9:16 o auto; predeterminada auto.'
          enum:
            - '16:9'
            - '9:16'
            - auto
          default: auto
          example: auto
        seed:
          type: integer
          description: >-
            Semilla aleatoria; aleatoria por defecto. Rango: `0`–`4294967295`.
            Fijar la semilla reduce la variación al ajustar los parámetros del
            prompt y mejora la reproducibilidad.
          minimum: 0
          maximum: 4294967295
          example: 42
        callback_url:
          type: string
          description: >-
            Direccion de callback HTTPS despues de completar la tarea


            **Momento del callback:**

            - Se activa cuando la tarea se completa (completed), falla (failed)
            o se cancela (cancelled)

            - Se envia despues de completar la confirmacion de facturacion


            **Restricciones de seguridad:**

            - Solo se admite el protocolo HTTPS

            - El callback a direcciones IP internas esta 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

            - Maximo `3` reintentos en caso de fallo (reintentos despues 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 direccion de callback que devuelve un codigo de estado 2xx se
            considera exitosa, otros codigos de estado activaran reintentos
          format: uri
          example: https://your-domain.com/webhooks/video-task-completed
      allOf:
        - if:
            properties:
              duration:
                type: integer
                minimum: 11
            required:
              - duration
          then:
            properties:
              video_urls:
                maxItems: 1
    VideoGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Marca de tiempo de creacion de la tarea
          example: 1757169743
        id:
          type: string
          description: ID de tarea
          example: task-unified-1757169743-7cvnl5zw
        model:
          type: string
          description: Nombre del modelo real utilizado
          example: gemini-omni-1.2-flash-reference-to-video
        object:
          type: string
          enum:
            - video.generation.task
          description: Tipo de tarea especifico
        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. El endpoint de creación siempre devuelve
            `processing`; el estado interno `pending` también se presenta a los
            clientes como `processing`.
          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/Usage'
          description: Informacion de uso y facturacion
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Identificador del codigo de error
            message:
              type: string
              description: Descripcion del error
            type:
              type: string
              description: Tipo de error
    VideoTaskInfo:
      type: object
      properties:
        can_cancel:
          type: boolean
          description: Si la tarea puede ser cancelada
          example: false
        estimated_time:
          type: integer
          description: Tiempo estimado de finalizacion (segundos)
          minimum: 0
          example: 60
        video_duration:
          type: integer
          description: Duración de salida; igual a duration.
          example: 3
    Usage:
      type: object
      description: Informacion de uso y facturacion
      properties:
        billing_rule:
          type: string
          description: Regla de facturacion
          enum:
            - per_call
            - per_token
            - per_second
          example: per_token
        credits_reserved:
          type: number
          description: Creditos estimados consumidos
          minimum: 0
          example: 102.34
        user_group:
          type: string
          description: Grupo de facturación al que pertenece el usuario
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##Todas las APIs requieren autenticacion Bearer Token##


        **Obtener API Key:**


        Visita la [Pagina de gestion 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.