Saltearse al contenido
Nappai Documentation

DALL·E Image Generator

El DALL·E Image Generator permite crear imágenes nuevas o modificar las existentes usando descripciones de texto. Conecta tu flujo de trabajo con la potente API de OpenAI para generar arte digital, ilustraciones o cualquier visual que necesites.

¿Cómo funciona?

Cuando configuras el componente, Nappai envía tu solicitud a la API de OpenAI. El texto que introduces (el Prompt) se envía al modelo DALL·E, que devuelve una imagen generada. Puedes elegir el modelo, la calidad, el tamaño y el estilo de la imagen. Si quieres usar el componente como una herramienta para un agente, también puedes definir un nombre y una descripción que el agente mostrará al seleccionar la herramienta.

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

  • Mapping Mode: Activa el modo de mapeo para procesar varios registros a la vez.
  • Image Model: Selecciona el modelo de DALL·E que se usará (por ejemplo, dall-e-2 o dall-e-3).
  • Prompt: Una descripción de texto de la imagen que deseas generar. Máximo 4000 caracteres.
  • Quality: Define la calidad de la imagen final (por ejemplo, standard o hd).
  • Size: El tamaño de la imagen generada. Varía según el modelo seleccionado.
  • Style: El estilo artístico de la imagen (por ejemplo, photorealistic, cartoon, oil painting).
  • Tool Name: Nombre que aparecerá cuando el componente se use como herramienta para un agente.
  • Tool Description: Descripción detallada de lo que hace la herramienta para que el agente la entienda.
  • Tools arguments metadata: Metadatos que describen los argumentos que la herramienta aceptará.

Credencial
Este componente necesita una credencial de tipo OpenAI API.

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

Salidas

  • Image: La imagen generada, entregada como un archivo binario que puedes usar en otros componentes o descargar.
  • Tool: Un objeto de herramienta que puede ser usado por agentes de IA para invocar esta generación de imágenes dentro de un flujo de conversación.

Ejemplo de Uso

  1. Configura la credencial: Asegúrate de haber creado y seleccionado la credencial “OpenAI API”.
  2. Activa Mapping Mode (opcional): Si quieres generar varias imágenes a la vez, activa el interruptor y conecta una fuente de datos.
  3. Rellena los campos:
    • Image Model: dall-e-3
    • Prompt: “Un castillo medieval en una isla flotante al atardecer, estilo impresionista”
    • Quality: hd
    • Size: 1024x1024
    • Style: impressionist
  4. Ejecuta el flujo. El componente devolverá la imagen en la salida Image y, si lo configuraste, la herramienta en Tool.

Componentes Relacionados

  • Image Resizer – Ajusta el tamaño de imágenes generadas o existentes.
  • Image Optimizer – Reduce el peso de las imágenes sin perder calidad.
  • Text to Image – Variante simplificada que solo necesita un prompt y devuelve una imagen.

Consejos y Mejores Prácticas

  • Limita la longitud del Prompt: Aunque el límite es 4000 caracteres, prompts más cortos suelen generar resultados más coherentes.
  • Usa estilos predefinidos: Los estilos disponibles están optimizados por OpenAI; usar uno de ellos suele dar mejores resultados que estilos personalizados.
  • Gestiona los costos: Cada generación consume créditos de OpenAI. Si usas Mapping Mode, revisa el número de registros para evitar sorpresas en la factura.
  • Prueba con prompts de ejemplo: Antes de usarlo en producción, prueba con prompts cortos para familiarizarte con la calidad y el estilo.

Consideraciones de Seguridad

  • Protege tu API Key: La credencial debe mantenerse en secreto; no la compartas en flujos públicos.
  • Control de acceso: Limita quién puede editar el componente y la credencial para evitar usos indebidos.
  • Revisa los límites de uso: OpenAI impone límites de tasa y de tokens; monitorea tu consumo para evitar bloqueos.