Saltearse al contenido
Nappai Documentation

Runway video Generator

El Runway video Generator es una herramienta que permite crear videos cortos a partir de una serie de imágenes y una descripción textual. Se conecta a la API de Runway ML, lo que significa que el procesamiento se realiza en la nube y el resultado es un video que puedes usar en tus flujos de trabajo de Nappai.

¿Cómo funciona?

Cuando configuras el componente, introduces una lista de imágenes (pueden ser URLs o identificadores de archivos guardados en Nappai) y escribes una descripción del video que quieres generar. El componente envía estos datos a la API de Runway junto con los parámetros que hayas elegido (aspect ratio, duración, modelo, etc.). Runway procesa la solicitud y devuelve un video que se guarda como un objeto de datos dentro de Nappai. Si el componente está conectado como herramienta, también puede ser llamado por un agente de IA para generar videos de forma automática.

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

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Image Files: La lista de archivos de imagen (URL o ID de archivo) que se usarán para la generación del video.
  • Aspect Ratio: El aspecto de la relación de aspecto del video generado.
  • Duration (seconds): La duración del video en segundos (5‑10 para Gen4/Gen3).
  • Generation Mode: Modo de generación del video.
  • Height: Altura del video generado en píxeles.
  • Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
  • Video Model: El modelo Runway ML que se usará para la generación del video.
  • Motion Intensity: Controla la cantidad de movimiento en el video (1‑255).
  • Negative Prompt: Lo que no quieres que aparezca en el video.
  • Prompt: Descripción textual del video deseado. La longitud máxima es de 512 caracteres.
  • Seed: Semilla aleatoria para resultados reproducibles. Déjalo vacío para aleatorio.
  • Width: Anchura del video generado en píxeles.
  • Tool Name: Nombre del herramienta que se usará cuando el componente esté conectado como herramienta.
  • Tool Description: Descripción detallada de lo que hace esta herramienta.
  • Tools arguments metadata: Define los metadatos de los argumentos para las herramientas.

Credencial
Este componente necesita una credencial de tipo Runway API.

  1. Configura primero la credencial en la sección de credenciales de Nappai.
  2. Luego selecciona esa credencial en el campo “Credential” del componente.
    La credencial requiere una Runway ML API Key que puedes obtener en el Runway Developer Portal.

Salidas

  • Video: Objeto de datos que contiene el video generado (método generate_video).
  • Tool: Objeto de herramienta que permite que un agente de IA invoque este componente (método to_toolkit).

Ejemplo de Uso

  1. Configura la credencial: Ve a Credenciales → Agregar credencial → selecciona Runway API y pega tu API Key.
  2. Añade el componente al flujo de trabajo y activa Mapping Mode si quieres procesar varias filas de datos.
  3. Rellena los campos:
    • Image Files: ["https://ejemplo.com/imagen1.jpg", "https://ejemplo.com/imagen2.jpg"]
    • Prompt: Un paisaje de montaña al amanecer con música suave
    • Duration (seconds): 8
    • Aspect Ratio: 16:9
    • Video Model: gen4
  4. Ejecuta el flujo. El componente enviará la solicitud a Runway y devolverá un video que puedes usar en un panel, enviar por correo o pasar a otro componente.

Componentes Relacionados

  • Runway Image Generator – Genera imágenes estáticas con Runway.
  • Runway Text-to-Image – Convierte texto en imágenes usando Runway.
  • Video Editor – Edita videos generados para recortar, añadir efectos o superposiciones.

Consejos y Mejores Prácticas

  • Mantén la duración corta (5‑10 segundos) para evitar tiempos de espera largos y costos de procesamiento.
  • Usa prompts claros y concisos; la descripción no debe superar los 512 caracteres.
  • Aprovecha el modo de mapeo para generar videos en lote a partir de una tabla de datos.
  • Revisa la política de uso de Runway para asegurarte de que tu contenido cumple con sus términos.
  • Guarda la salida en un bucket de Nappai para reutilizarla en otros flujos.

Consideraciones de Seguridad

  • La API Key de Runway debe mantenerse confidencial. No la compartas en flujos públicos ni la incluyas en scripts visibles.
  • Configura la credencial en la sección de credenciales de Nappai, donde se almacena de forma segura.
  • Si compartes el flujo con otros usuarios, asegúrate de que tengan acceso a la credencial o crea una credencial compartida con los permisos adecuados.