Saltearse al contenido
Nappai Documentation

Fal.ai Image Generator

Genera imágenes de alta calidad a partir de descripciones de texto o de otras imágenes, utilizando los modelos de Fal.ai. El componente permite ajustar el tamaño, el número de imágenes, y aplicar filtros negativos, entre otras opciones, y se integra directamente con la API de Fal.ai.

¿Cómo funciona?

El componente envía una solicitud HTTP a la API de Fal.ai con los parámetros que configures (prompt, modelo, tamaño, etc.). Fal.ai procesa la petición y devuelve los archivos de imagen generados. Si seleccionas el modo image_to_image, también envías una imagen de referencia que sirve como base para la generación. El componente puede trabajar en modo de mapeo, procesando varios registros a la vez y devolviendo una imagen por cada entrada.

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.

Credencial requerida: Este componente necesita una credencial de tipo Fal.ai API.

  1. Configura la credencial en la sección de credenciales de Nappai.
  2. Selecciona esa credencial en el campo Credential del componente.

Campos de Entrada

  • Image Files: La lista de archivos de imagen (URL o ID de archivo) que se usarán como referencia en el modo image_to_image.
  • Generation Mode: Modo de generación de imagen. Puede ser text_to_image (generar a partir de texto) o image_to_image (generar a partir de una imagen).
  • Height: Altura de la imagen generada en píxeles (para tamaños personalizados).
  • Image to Image mode: Modo de generación de video (se utiliza cuando se trabaja con secuencias de imágenes).
  • Image size / Aspect Ratio: Tamaño/relación de aspecto de la imagen generada (por ejemplo, 1:1, 16:9, etc.).
  • Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
  • Image Model: El modelo de Fal.ai que se usará para la generación (por ejemplo, “fal-ai-image-1.0”).
  • Negative Prompt: Lo que no quieres que aparezca en la imagen (compatible con la mayoría de los modelos).
  • Number of Images: Número de imágenes a generar (1‑4).
  • Prompt: Descripción de texto de la imagen deseada. La longitud máxima varía según el modelo.
  • Model Specific Parameters: Parámetros específicos de cada modelo. Consulta la documentación de Fal.ai para detalles: https://fal.ai/models.
  • Width: Anchura de la imagen generada en píxeles (para tamaños personalizados).
  • 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.

Salidas

  • Image: Archivo binario de la imagen generada (método: generate_image_file).
  • Tool: Objeto de herramienta (método: to_toolkit) que permite que el componente sea usado por agentes de IA.

Ejemplo de Uso

  1. Configura la credencial: Ve a Credenciales → Agregar credencial → selecciona Fal.ai API y pega tu API Key.
  2. Añade el componente: Arrastra Fal.ai Image Generator al flujo.
  3. Selecciona la credencial: En el campo Credential, elige la credencial que acabas de crear.
  4. Configura los parámetros:
    • Generation Mode: text_to_image
    • Prompt: “Un atardecer sobre un lago con montañas al fondo”
    • Image Model: fal-ai-image-1.0
    • Number of Images: 2
    • Height: 1024
    • Width: 1024
  5. Ejecuta el flujo: El componente devolverá dos archivos de imagen en la salida Image que puedes usar en otros componentes o descargar.

Componentes Relacionados

  • FalAiTextGenerator – Genera texto con modelos de Fal.ai.
  • FalAiImageGenerator – Este mismo componente, útil para generar imágenes a partir de texto o imágenes.
  • FalAiVideoGenerator – Genera videos a partir de secuencias de imágenes o texto.

Consejos y Mejores Prácticas

  • Elige el modelo correcto: Los modelos de Fal.ai varían en calidad y velocidad; prueba varios para encontrar el que mejor se adapte a tu caso.
  • Usa prompts claros y concisos: Los modelos responden mejor a descripciones específicas y bien estructuradas.
  • Aprovecha el modo de mapeo: Si necesitas generar imágenes para muchos registros, activa Mapping Mode y conecta la entrada Mapping Data a la fuente de datos.
  • Controla el tamaño: Ajusta Height y Width solo cuando necesites un tamaño personalizado; de lo contrario, usa la opción Image size / Aspect Ratio para mantener la calidad.
  • Utiliza Negative Prompt: Si quieres evitar ciertos elementos (por ejemplo, texto incrustado), inclúyelo en este campo.
  • Limita el número de imágenes: El límite es 4 por solicitud; generar más puede requerir múltiples llamadas.

Consideraciones de Seguridad

  • Protege tu API Key: No compartas la credencial en archivos públicos ni la incluyas en el código fuente.
  • Revisa los permisos: Asegúrate de que la credencial tenga solo los permisos necesarios para generar imágenes.
  • Monitorea el uso: Fal.ai puede cobrar por cada imagen generada; revisa tu facturación para evitar sorpresas.
  • Valida las entradas: Evita enviar prompts que contengan contenido sensible o prohibido por la política de Fal.ai.