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-1.5	Generación y edición rápida de imágenes GPT con fuerte renderizado de texto.
gpt-image-2	Niveles de calidad OpenAI, tamaños personalizados, salidas más grandes y edición de imágenes.

Campos de GPT Image

Campo	Tipo	Obligatorio	Descripción
model	string	Sí	Usa gpt-image-1.5 o gpt-image-2.
prompt	string	Sí	Prompt de imagen, hasta el límite de prompt del modelo seleccionado.
image	string o string[]	Obligatorio para edición	URL de imagen de entrada, o un array de URLs cuando se soporten varias referencias.
n	number	No	Número de imágenes.
size	string	No	auto, popular preset sizes such as 1024x1024, 1536x1024, or 1024x1536, or a custom WIDTHxHEIGHT value.
quality	string	No	low, medium, high o auto cuando esté soportado.

Los tamaños personalizados deben usar el formato WIDTHxHEIGHT, mantenerse dentro de los límites del proveedor y ajustarse al nivel de salida seleccionado.

Precios

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

Para gpt-image-2, los créditos por imagen siguen la matriz documentada de tamaño y calidad. 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',
    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",
    "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"
    }
  ]
}