Generar Imagen

Propósito

Genera imágenes de IA basadas en prompts de texto. Opcionalmente, puedes subir imágenes de referencia para guiar el estilo o composición del resultado generado.

Método y Ruta

POST /public/v1/generate/image

Autenticación

Consulta la página de autenticación. Se requiere un token Bearer.

Encabezados Requeridos:

Authorization: Bearer {your_api_key}

Campos de Solicitud

Nombre del Campo	Tipo	Requerido	Descripción
prompt	string	Sí	Prompt de texto para la generación de imágenes
ai_model	string	Sí	Modelo de IA a usar. Valores posibles: GPT Image 1.5, GPT Image 2, Grok Imagine, Grok Imagine Pro, Nano Banana, Nano Banana 2, Nano Banana Pro
ref_images	file[]	No	Archivos de imagen de referencia (multipart/form-data). El número máximo de archivos varía según el modelo de IA

Respuesta

Respuesta Exitosa (200 OK):

{
  "job_id": "uuid-string"
}

Campo	Tipo	Descripción
job_id	string	Identificador único del trabajo creado. Consulta los resultados con Get Job Status

Reglas de Error / Validación

Situación	Estado HTTP	Mensaje de Error
Invalid image file	400	"Invalid image file"
Más de 5 ref_images con modelo Grok Imagine	400	"The Grok Imagine model supports up to 5 ref_images."
Más de 1 ref_images con modelo Grok Imagine Pro	400	"The Grok Imagine Pro model supports up to 1 ref_images."
Más de 10 ref_images con otros modelos	400	"ref_images supports up to 10 images only"
Fallo de autenticación	401	Clave de API inválida

Límites de Imágenes de Referencia:

• GPT Image 1.5: máximo 10
• Grok Imagine: máximo 5
• Grok Imagine Pro: máximo 1
• Familia Nano Banana: máximo 10

Comportamiento de Trabajos Asíncronos

Este endpoint crea un trabajo asíncrono. Devuelve inmediatamente un job_id, y la generación real de la imagen ocurre en segundo plano.

Método de Polling:

1. Guarda el job_id recibido en la respuesta
2. Haz polling a GET /public/v1/job/{job_id} para verificar el estado
3. Cuando el estado sea Succeed, consulta los resultados en image_urls

Flujo de Estado: Pending → Succeed o Failed

Ejemplo de Solicitud

cURL (sin imágenes de referencia):

curl -X POST "https://api.aetherforgeai.com/public/v1/generate/image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "prompt=a beautiful sunset over mountains" \
-F "ai_model=GPT Image 1.5"

cURL (con imágenes de referencia):

curl -X POST "https://api.aetherforgeai.com/public/v1/generate/image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "prompt=a cat in the style of the reference" \
-F "ai_model=Grok Imagine" \
-F "ref_images=@/path/to/ref1.jpg" \
-F "ref_images=@/path/to/ref2.jpg"