Saltearse al contenido
Nappai Documentation

Runway Image Generator

El Runway Image Generator te permite crear imágenes nuevas a partir de texto o de otras imágenes usando los modelos de Runway ML. Solo necesitas escribir una descripción o subir una imagen de referencia, y el componente se encargará de generar la imagen final.

¿Cómo funciona?

El componente envía tus parámetros (prompt, modelo, tamaño, etc.) a la API de Runway ML. Runway procesa la solicitud y devuelve una imagen generada. El flujo es sencillo: tú configuras los campos, el componente hace la llamada a la API y devuelve la imagen lista para usar en tu dashboard o en otro proceso.

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 ser usado en modo fijo, mapeado o con Javascript.

  • Image Files: La lista de archivos de imagen (URL o ID de archivo) que usarás como referencia para la generación.
  • Aspect Ratio: El aspecto de la imagen generada (por ejemplo, 1:1, 16:9, etc.).
  • Generation Mode: Modo de generación de imagen. Puedes elegir entre text_to_image (generar a partir de texto) o image_to_image (generar a partir de una imagen de referencia).
  • Height: Altura de la imagen generada en píxeles.
  • Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
  • Image Model: El modelo de Runway ML que se usará para la generación (por ejemplo, “Stable Diffusion” o “Imagen”).
  • Negative Prompt: Descripción de lo que no quieres que aparezca en la imagen.
  • Number of Images: Número de imágenes a generar (entre 1 y 4).
  • Prompt: Descripción textual de la imagen deseada. El máximo es de 1000 caracteres.
  • Seed: Semilla aleatoria para resultados reproducibles. Déjalo vacío para que sea aleatorio.
  • Width: Anchura de la imagen generada en píxeles.
  • Tool Name: Nombre del tool que se mostrará al agente cuando el componente se use como herramienta.
  • Tool Description: Descripción detallada de lo que hace el tool para que el agente lo entienda.
  • Tools arguments metadata: Metadatos de los argumentos que el tool aceptará.

Credencial
Este componente necesita una credencial de tipo Runway API.

  1. Configura la credencial en la sección de credenciales de Nappai.
  2. 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

  • Image: Devuelve la imagen generada como un archivo de datos (generate_image_file). Puedes usarla directamente en tu dashboard o guardarla para futuros procesos.
  • Tool: Devuelve un objeto de herramienta (to_toolkit) que permite a los agentes de IA usar este componente como una acción dentro de sus flujos de trabajo.

Ejemplo de Uso

  1. Activar Modo de Mapeo: Si quieres generar imágenes para cada registro de una tabla, activa el interruptor “Mapping Mode”.
  2. Configurar Prompt: Escribe “Un paisaje futurista con luces de neón” en el campo Prompt.
  3. Seleccionar Modelo: Elige “Stable Diffusion” en Image Model.
  4. Definir Tamaño: Pon 512 en Width y 512 en Height.
  5. Ejecutar: Haz clic en “Run”.
    El componente enviará la solicitud a Runway, recibirá la imagen y la mostrará en la salida Image. Si lo conectas a un flujo de trabajo, la imagen puede ser guardada, mostrada en un panel o enviada a otro componente.

Componentes Relacionados

  • BaseRunwayImageGeneration – Base que maneja la lógica común de generación de imágenes con Runway.
  • Runway Video Generator – Si necesitas generar videos en lugar de imágenes, este componente es el equivalente para video.

Consejos y Mejores Prácticas

  • Limita el Prompt: Mantén el texto breve y claro; los prompts largos pueden generar resultados inesperados.
  • Usa Seeds: Si necesitas reproducir exactamente la misma imagen, especifica un número en Seed.
  • Controla el Tamaño: Los tamaños mayores consumen más recursos y pueden tardar más en generar.
  • Prueba con Múltiples Modelos: Experimenta con diferentes modelos de Runway para ver cuál se adapta mejor a tu estilo.
  • Gestiona la Credencial: Guarda la API Key en la sección de credenciales y no la expongas en el flujo de trabajo.

Consideraciones de Seguridad

  • La API Key de Runway debe mantenerse confidencial. No la incluyas en archivos de código ni la compartas públicamente.
  • Asegúrate de que solo los usuarios autorizados tengan acceso a la credencial en Nappai.
  • Revisa los límites de uso de la API de Runway para evitar sobrecargas o cargos inesperados.