Saltearse al contenido
Nappai Documentation

Gemini Video Generator

Gemini Video Generator es un componente de Nappai que permite crear videos a partir de texto o imágenes usando los modelos de Google Gemini. Con él, puedes generar clips cortos y personalizados directamente desde tu dashboard sin necesidad de escribir código.

¿Cómo funciona?

Cuando configuras el componente, Nappai envía una solicitud a la API de Google Gemini. La API recibe los parámetros que has elegido (aspecto, duración, modelo, etc.) y devuelve un video generado automáticamente. El proceso es rápido y no requiere que el usuario tenga conocimientos técnicos sobre la API; simplemente seleccionas las opciones y Nappai se encarga del resto.

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

  • Aspect Ratio: El formato del video. Puedes elegir entre 9:16 (vertical) o 16:9 (horizontal).
  • Duration (seconds): La duración del video en segundos.
  • Generation Mode: Define cómo se generará el video. Puedes seleccionar text_to_image para crear un video a partir de una descripción textual o image_to_image para transformar una imagen existente en un video.
  • Mapping Mode: Interruptor que activa el modo de mapeo descrito arriba.
  • Video Model: El nombre del modelo Gemini que se utilizará para la generación.
  • Prompt: Una descripción textual del video que deseas crear. El texto puede tener hasta 4000 caracteres.
  • Tool Name: El nombre que aparecerá cuando el componente se utilice como herramienta por un agente.
  • Tool Description: Una descripción detallada de lo que hace la herramienta, útil para que el agente la elija correctamente.
  • Tools arguments metadata: Metadatos que definen los argumentos que la herramienta aceptará.

Credencial requerida
Este componente necesita una credencial de tipo Google Gemini API.

  1. Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada “Google Gemini API”.
  2. Ingresa tu Google Api Key (es un campo de tipo password).
  3. En el componente, selecciona la credencial recién creada en el campo “Credential”.

Salidas

  • Video: Devuelve el video generado. El tipo de dato es Data y se obtiene mediante el método generate_video. Puedes usarlo en otros componentes que requieran un video como entrada.
  • Tool: Devuelve una herramienta (Tool) que puede ser utilizada por agentes de IA. El método to_toolkit convierte la configuración del componente en una herramienta lista para usar.

Ejemplo de Uso

  1. Crear un video promocional
    • Aspect Ratio: 16:9
    • Duration (seconds): 10
    • Generation Mode: text_to_image
    • Prompt: “Un paisaje futurista con luces de neón, estilo cyberpunk, con música electrónica de fondo.”
    • Video Model: gemini-pro-vision
    • Activa Mapping Mode si quieres generar varios videos a partir de una lista de prompts.
    • Selecciona la credencial “Google Gemini API”.
    • Ejecuta el flujo. El componente devolverá un video de 10 segundos que puedes insertar en tu dashboard o compartir con tu equipo.

Componentes Relacionados

  • Gemini Image Generator – Genera imágenes estáticas con Gemini.
  • BaseGeminiVideoGenerator – Clase base que comparte lógica común con otros generadores de video.
  • Text to Video – Otro componente que convierte texto en video usando modelos diferentes.

Consejos y Mejores Prácticas

  • Limita la longitud del Prompt: Aunque el límite es 4000 caracteres, textos más cortos suelen generar resultados más coherentes.
  • Prueba con diferentes modelos: Algunos modelos son más rápidos pero menos detallados; elige según la calidad que necesites.
  • Usa Mapping Mode para batch: Si necesitas crear varios videos a la vez, activa Mapping Mode y conecta una lista de prompts.
  • Revisa la duración: Los videos muy largos pueden tardar más en generarse y consumir más recursos.
  • Guarda la credencial: Mantén tu Google Api Key segura y no la compartas públicamente.

Consideraciones de Seguridad

  • La credencial Google Gemini API contiene tu Google Api Key, que es una información sensible. No la expongas en flujos públicos ni la compartas con usuarios que no necesiten acceso.
  • Nappai almacena la clave de forma cifrada; sin embargo, es buena práctica rotar la clave periódicamente.
  • Si compartes el flujo con otros usuarios, asegúrate de que tengan acceso a la credencial o crea una credencial específica para ese flujo.