Generación de imágenes GPT-Image-2

• Modelo: gpt-image-2
• Endpoint: POST https://apimaster.ai/v1/images/generations
• Modo: Asíncrono — devuelve task_id, luego consulta la tarea
• Características: Texto a imagen; imagen a imagen con hasta 16 imágenes de referencia (mezcla de URL y base64)

Autenticación

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Parámetros del cuerpo

Campo	Tipo	Obligatorio	Notas
model	string	sí	gpt-image-2
prompt	string	sí	Descripción de la escena; se aplica moderación de seguridad
n	integer	no	Solo 1 (numérico, sin comillas)
size	string	no	Relación de aspecto, predeterminado 1:1
resolution	string	no	1k / 2k / 4k, predeterminado 1k
image_urls	array	no	Imágenes de referencia → imagen a imagen
official_fallback	boolean	no	Recurso de canal oficial, predeterminado false

Valores de size

auto, 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21, o cadenas de píxeles como 3840x2160.

Resolución (píxeles de muestra)

tamaño	1k	2k	4k
1:1	1024×1024	2048×2048	2880×2880
16:9	1536×864	2048×1152	3840×2160

Los 15 ratios admiten 4K.

image_urls

• Máximo 16 imágenes
• Se pueden mezclar URLs públicas y URIs de datos base64
• Omite size para seguir la resolución de entrada; establece size para forzar la relación de aspecto de salida

Ejemplos

Texto a imagen mínimo

{
  "model": "gpt-image-2",
  "prompt": "An orange cat on a windowsill at sunset, watercolor"
}

16:9 @ 2K

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a corgi astronaut on the moon, cinematic",
    "size": "16:9",
    "resolution": "2k"
  }'

Respuesta de envío

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA" }]
}

HTTP	Significado
400	Parámetros inválidos
401	Clave API incorrecta
402	Saldo insuficiente
429	Límite de velocidad excedido

Consultar resultado de la tarea

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

URL de la imagen: data.result.images[0].url[0]

estado	Significado
submitted	En cola
processing	En ejecución
completed	Listo
failed	Ver error

Consulta después de 10–20s, cada 3–5s. Lote: POST https://apimaster.ai/v1/tasks/batch con {"task_ids":[...]}.

Notas

• Solo asíncrono — no hay URL de imagen síncrona en la respuesta de creación.
• Prefiere size para la relación de aspecto; evita repetir la relación en prompt.
• Facturación por nivel de resolución; consulta la consola para tu cuenta.

Compara con canal oficial.