GPT Image

Los modelos GPT Image son útiles cuando la adherencia al prompt, el renderizado de texto, la composición limpia o los tamaños de salida grandes importan. Pixapi los expone a través de endpoints de imagen compatibles con OpenAI.

Superficie de API

Operación	Endpoint	Modo
Generación de imágenes	POST /v1/images/generations	Síncrono
Tarea de generación de imágenes	POST /v1/async/images/generations	Asíncrono
Edición de imágenes	POST /v1/images/edits	Síncrono
Tarea de edición de imágenes	POST /v1/async/images/edits	Asíncrono

IDs de modelo

ID del modelo	Ideal para
gpt-image-2.5-flare	Generación orientada a velocidad, variantes de productos y creación a gran escala.
gpt-image-2.5-sunburst	Composiciones orientadas a calidad, campañas y edición precisa de imágenes.
gpt-image-2	Niveles de calidad OpenAI, tamaños personalizados, salidas más grandes y edición de imágenes.
gpt-image-1.5	Generación y edición rápida de imágenes GPT con fuerte renderizado de texto.

Flare y Sunburst usan los mismos parámetros, endpoints síncronos/asíncronos de generación y edición, y precios en créditos que GPT Image 2. Solo cambia el valor de model.

Campos de solicitud

Envía los campos comunes en el nivel superior y los controles específicos dentro de providerOptions.

Campo	Tipo	Obligatorio	Descripción
model	string	Sí	gpt-image-2, gpt-image-1.5, gpt-image-2.5-flare, gpt-image-2.5-sunburst. ID sensible a mayúsculas.
prompt	string	Sí	Describe el sujeto, la composición, el estilo y los cambios. Pixapi conserva los primeros 2.000 caracteres; el prompt es obligatorio también al editar.
n	integer	No	Predeterminado 1; solo admite el entero 1.
size	string	No	Usa píxeles ANCHOxALTO, por ejemplo 1024x1024 Predeterminado auto. Dimensiones múltiplos de 16, lado mayor ≤ 3840, proporción ≤ 3:1 y 655.360–8.294.400 píxeles.
image	string / string[]	Para edición	URL HTTP(S) pública o lista de URLs; obligatoria en /images/edits. Hasta 14 URLs; no admite Base64.
quality	string	No	auto (predeterminado), low, medium o high; mayor calidad puede tardar más.
providerOptions	object	No	Opciones específicas; consulta la tabla siguiente.

providerOptions

Todos estos campos van dentro de providerOptions, no junto a model.

Campo	Tipo	Descripción
output_format	string	Formato de la imagen de salida: png (predeterminado, conserva transparencia), jpeg (archivos más pequeños, sin alpha) o webp (admite transparencia).
background	string	Modo de fondo: auto (predeterminado), opaque o transparent. transparent solo se puede combinar con output_format: "png" u output_format: "webp"; JPEG no admite canal alfa.
moderation	string	Intensidad de la moderación de contenido: auto o low (más permisiva). Predeterminado: auto para 1.5/2, low para 2.5.
output_compression	integer	Nivel de compresión de salida 0–100; solo para salidas jpeg y webp.
mask_url	string	URL pública de máscara PNG. Requiere image y las dimensiones de la primera imagen. Los píxeles transparentes marcan la zona editable; PNG con canal alfa, menos de 4 MB.
nsfw_check	boolean	Moderación opcional del prompt y las imágenes; predeterminado false.

Reglas de entrada

Pixapi admite una salida y hasta 14 referencias. Los píxeles de salida se eligen con size.

Los tamaños personalizados deben usar el formato WIDTHxHEIGHT (por ejemplo 1536x864) y cumplir a la vez todos los límites siguientes:

Límite	Requisito
Múltiplo de 16	Tanto el ancho como el alto deben ser divisibles por 16.
Relación de aspecto	Entre 1:3 y 3:1.
Borde más largo	Ningún borde puede superar los 3840px.
Píxeles mínimos	Al menos 655.360 (aproximadamente 1024x640).
Píxeles máximos	Como máximo 8.294.400 (4K, igual a 3840x2160).

Como el techo se calcula sobre el total de píxeles, 4K no equivale a un borde de 3840px: en un lienzo cuadrado el borde llega como máximo a 2880x2880 (√8.294.400 = 2880). Tamaño máximo disponible por formato:

Formato	Tamaño	Píxeles totales
Horizontal	3840x2160	8.294.400
Vertical	2160x3840	8.294.400
Cuadrado	2880x2880	8.294.400
Ultra ancho 3:1	3840x1280	4.915.200

Las salidas superiores a 2560x1440 son experimentales y no se garantiza su estabilidad.

Precios

Modelo	Créditos por imagen
gpt-image-2.5-flare	desde 1
gpt-image-2.5-sunburst	desde 1
gpt-image-2	desde 1
gpt-image-1.5	desde 1

gpt-image-1.5 solo se factura en tamaños 1K (1024x1024, 1536x1024, 1024x1536 o auto): low/medium/high es 1/4/14. No admite salidas 2K o 4K.

Para gpt-image-2, gpt-image-2.5-flare y gpt-image-2.5-sunburst, los créditos siguen la matriz de tamaño y calidad documentada. quality=auto se factura como high, y size=auto usa por defecto el nivel 1K.

Nivel de tamaño	Borde largo	low	medium	high / auto
1K	<= 1536px	1	4	14
2K	<= 2048px	2	17	67
4K	<= 3840px	4	34	133

El costCredits mostrado para una petición es igual al valor de la matriz por n.

Ejemplo de generación

const response = await fetch('https://api.pixapi.ai/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'gpt-image-2.5-flare',
    prompt: 'A clean SaaS hero image showing API model orchestration',
    n: 1,
    size: '1536x1024',
    quality: 'high',
  }),
});

const image = await response.json();

Ejemplo de edición

curl https://api.pixapi.ai/v1/images/edits \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "Replace the background with a bright studio setup",
    "image": "https://cdn.example.com/input.png",
    "size": "auto",
    "quality": "auto"
  }'

Respuesta

{
  "created": 1766880000,
  "data": [
    {
      "url": "https://cdn.pixapi.ai/generated/gpt-image.png"
    }
  ]
}