> ## 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 Edición de vídeo

> - Gemini Omni 1.2 Flash (`gemini-omni-1.2-flash-video-edit`) edita un vídeo mediante un prompt y referencias visuales opcionales.
- **Vídeo:** `video_urls` requiere exactamente 1 vídeo de hasta 15 segundos.
- **Imágenes:** Hasta 10 imágenes de referencia opcionales con `image_urls`.
- **Resolución:** `quality`: `360p`, `720p`, `1080p`, `4k` o `auto`; `auto` por defecto conserva la entrada. Un valor concreto permite aumentar o reducir la resolución de salida.
- **Duración:** `duration` solo admite `auto`, también predeterminado; sigue la entrada.
- **Relación de aspecto:** `aspect_ratio` solo admite `auto`, también predeterminado; sigue la entrada.
- Describe la edición con `prompt`; incluye allí las restricciones negativas. No hay un parámetro independiente de prompt negativo.
- Audio nativo sincronizado automático, sin parámetros adicionales.
- 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-video-edit.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: Gemini Omni 1.2 Flash Edición de vídeo
  description: Edita un vídeo con imágenes de referencia opcionales
  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 Edición de vídeo
      description: >-
        - Gemini Omni 1.2 Flash (`gemini-omni-1.2-flash-video-edit`) edita un
        vídeo mediante un prompt y referencias visuales opcionales.

        - **Vídeo:** `video_urls` requiere exactamente 1 vídeo de hasta 15
        segundos.

        - **Imágenes:** Hasta 10 imágenes de referencia opcionales con
        `image_urls`.

        - **Resolución:** `quality`: `360p`, `720p`, `1080p`, `4k` o `auto`;
        `auto` por defecto conserva la entrada. Un valor concreto permite
        aumentar o reducir la resolución de salida.

        - **Duración:** `duration` solo admite `auto`, también predeterminado;
        sigue la entrada.

        - **Relación de aspecto:** `aspect_ratio` solo admite `auto`, también
        predeterminado; sigue la entrada.

        - Describe la edición con `prompt`; incluye allí las restricciones
        negativas. No hay un parámetro independiente de prompt negativo.

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

        - 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: createGeminiOmni12FlashVideoEditGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GeminiOmni12FlashVideoEditRequest'
            examples:
              video_edit:
                summary: Edición de vídeo
                value:
                  model: gemini-omni-1.2-flash-video-edit
                  prompt: >-
                    Haz que la iluminación sea más cálida y mantén todo lo demás
                    sin cambios.
                  video_urls:
                    - https://example.com/source.mp4
                  quality: auto
                  duration: auto
                  aspect_ratio: auto
              video_edit_with_reference:
                summary: Edición con imagen de referencia
                value:
                  model: gemini-omni-1.2-flash-video-edit
                  prompt: >-
                    Mantén el estilo de ropa de la persona de acuerdo con la
                    imagen de referencia y conserva los demás movimientos de
                    cámara.
                  video_urls:
                    - https://example.com/source.mp4
                  image_urls:
                    - https://example.com/reference.png
                  quality: auto
                  duration: auto
                  aspect_ratio: auto
      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-video-edit
                  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:
    GeminiOmni12FlashVideoEditRequest:
      required:
        - model
        - prompt
        - video_urls
      type: object
      additionalProperties: false
      properties:
        model:
          type: string
          description: Nombre del modelo, fijo en `gemini-omni-1.2-flash-video-edit`
          enum:
            - gemini-omni-1.2-flash-video-edit
          example: gemini-omni-1.2-flash-video-edit
          default: gemini-omni-1.2-flash-video-edit
        prompt:
          type: string
          description: >-
            Instrucción que describe la edición deseada y lo que debe
            conservarse.


            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: >-
            Haz que la iluminación sea más cálida y mantén todo lo demás sin
            cambios.
          minLength: 1
          pattern: \S
        video_urls:
          type: array
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 1
          description: >-
            Array de vídeos para editar; exactamente 1 vídeo. Solo URL
            HTTP/HTTPS de vídeo, formato mp4. Duración máxima de `15` segundos,
            sin mínimo; también se aceptan vídeos de 1–2 segundos.
          example:
            - https://example.com/source.mp4
        image_urls:
          type: array
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 10
          description: >-
            Array opcional de imágenes de referencia, hasta 10 imágenes, para
            restringir sujetos, estilo o elementos.


            **Requisitos de entrada:**

            - Solo URL de imagen HTTP/HTTPS

            - Formatos admitidos: `png`, `jpeg`, `webp`


            **Facturación:** Cada imagen de referencia aporta tokens de entrada.
          example:
            - https://example.com/reference.png
        quality:
          type: string
          description: >-
            Resolución de salida; predeterminada `auto`.


            - `360p`: lado corto 360.

            - `720p`: lado corto 720.

            - `1080p`: lado corto 1080.

            - `4k`: lado corto 2160.

            - `auto`: conserva la resolución de entrada; valor predeterminado.


            Elegir un valor concreto permite aumentar o reducir la resolución de
            salida.


            **Facturación:** Los tokens de vídeo de salida aumentan con su
            resolución. El vídeo de entrada también aporta tokens; una
            resolución mayor cuesta más.
          enum:
            - 360p
            - 720p
            - 1080p
            - 4k
            - auto
          default: auto
          example: auto
        duration:
          type: string
          description: >-
            Solo se permite auto y es el valor predeterminado; la duración sigue
            el vídeo de entrada.
          enum:
            - auto
          default: auto
          example: auto
        aspect_ratio:
          type: string
          description: >-
            Solo se permite auto y es el valor predeterminado; la relación sigue
            el vídeo de entrada.
          enum:
            - 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
    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-video-edit
        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: La duración de salida sigue el vídeo de entrada.
          example: 5
    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.