OpenAI Generate Image

Descripcion

Este modulo genera imagenes a partir de texto utilizando el modelo DALL-E 3 de OpenAI. Su flujo de ejecucion es:

1. Obtiene las credenciales (apiKey) desde el sistema de credenciales.
2. Determina el prompt a utilizar, con prioridad: data.prompt_image > data.prompt > config.prompt.
3. Envia una solicitud a la API de generacion de imagenes de OpenAI con el modelo DALL-E 3 y tamano 1024x1024.
4. Descarga la imagen generada desde la URL temporal de OpenAI.
5. Guarda la imagen localmente en el directorio temporal/cli_{client_id}/ con un nombre UUID unico.
6. Genera una URL publica de descarga basada en ENGINE_HOST.
7. Retorna la URL de OpenAI, la URL publica de descarga y la ruta local del archivo.

Si el prompt proviene de data.prompt_image, los datos originales se preservan en la respuesta (modo persistente).

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credenciales de la API de OpenAI (apiKey).
prompt	textarea	Si	Descripcion textual de la imagen a generar.
size	text	No	Tamano de la imagen. El modulo usa internamente 1024x1024 con DALL-E 3.

Credenciales

Se requiere credentials_id con un objeto que contenga apiKey (clave de API de OpenAI con acceso a DALL-E).

Salida

{
  "nextModule": "siguiente-nodo",
  "data": {
    "imageUrl": "https://oaidalleapiprodscus.blob.core.windows.net/...",
    "urlPath": "https://mi-engine.com/download/cli_1/abc123.png",
    "localPath": "/app/temporal/cli_1/abc123.png"
  },
  "_meta_": {
    "prompt": "Un gato astronauta en la luna",
    "tokens_consumed": 0.4
  }
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "credencial-openai",
  "prompt": "Un paisaje futurista de una ciudad con edificios flotantes al atardecer"
}

API Utilizada

• OpenAI Images API: POST https://api.openai.com/v1/images/generations
• Modelo: DALL-E 3
• Autenticacion: Bearer token con apiKey.

Notas

• Las imagenes se generan siempre en tamano 1024x1024 con DALL-E 3, independientemente del parametro size configurado.
• La imagen se guarda localmente en temporal/cli_{client_id}/ y es accesible via la URL de descarga del engine.
• La URL de OpenAI (imageUrl) es temporal y expira despues de un tiempo.
• El directorio temporal se crea automaticamente si no existe.
• El costo estimado se reporta como 0.4 en _meta_.tokens_consumed (referencia aproximada).
• Si data.prompt_image existe, se activa el modo persistente que preserva todos los datos originales en la respuesta.

Nodos Relacionados

• openaiAccess - OpenAI API (para generacion de texto)
• gemini - Gemini AI (alternativa de Google)