OpenAI gpt-image-2: error 400 con fondo transparente

Respuesta corta: transparent funciona con png o webp

OpenAI habilitó los fondos transparentes para openai/gpt-image-2 como versión preliminar el 20 de agosto de 2026; antes de esa fecha, background transparent se rechazaba con un 400. LLMTR (llmtr.com) es una pasarela que da acceso a modelos de lenguaje alojados en Turquía y en proveedores globales a través de una única API compatible con OpenAI. En la URL base https://llmtr.com/v1, el endpoint https://llmtr.com/v1/images/generations acepta background transparent con output_format png o webp.

jpeg no tiene canal alfa, por eso transparent con output_format jpeg devuelve HTTP 400 con tipo invalid_request y el mensaje transparent background requires output_format png or webp. La función es preliminar y OpenAI puede cambiar su comportamiento. Los otros valores de background, opaque y auto, se aceptan igual que antes.

OpenAI gpt-image-2: error 400 transparent background is not supported for this model

Este 400 es la respuesta de OpenAI anterior al 20 de agosto de 2026; desde entonces gpt-image-2 acepta background transparent como versión preliminar. Si la misma solicitud sigue devolviendo 400, revisa output_format: en LLMTR, transparent con jpeg se rechaza con tipo invalid_request y el mensaje transparent background requires output_format png or webp.

Cambia output_format a png o webp. png no tiene pérdida y es la opción más común; webp produce archivos más pequeños y admite output_compression. Si no envías output_format, el valor predeterminado es png, así que background transparent funciona también por sí solo. El endpoint de generación de imágenes no acepta image_url, image_urls, file_id, file_ids, mask, stream ni partial_images para OpenAI.

• OpenAI API changelog, 2026-08-20 · 2026-10-07
• OpenAI API docs, Image generation guide · 2026-10-06
• OpenAI API docs, gpt-image-2 · 2026-10-06

Parámetros válidos de gpt-image-2 en LLMTR

En POST https://llmtr.com/v1/images/generations, estos son los parámetros admitidos para gpt-image-2. background admite opaque, auto y transparent; transparent solo con png o webp. output_compression acepta el intervalo 0-100 únicamente con output_format jpeg o webp; con png devuelve 400 invalid_request. moderation admite auto o low.

La solicitud que funciona: fondo transparente y PNG

Usa una solicitud POST a https://llmtr.com/v1/images/generations con model openai/gpt-image-2, un prompt que pida el objeto centrado y sin fondo, background transparent y output_format png. La transparencia la decide el campo background, no el prompt.

La respuesta entrega data[0].b64_json y mime_type; con esta configuración, mime_type es image/png. Al decodificar el base64 y guardarlo en un archivo, el PNG conserva el canal alfa. Para el mismo endpoint, size puede ser 1024x1024, quality puede ser medium y n admite entre 1 y 4 imágenes. Con output_format jpeg la misma solicitud se rechaza con 400 invalid_request antes de llegar al modelo.

Solicitud curl para generar un icono con fondo transparente usando background transparent y output_format png.

curl https://llmtr.com/v1/images/generations \
  -H "Authorization: Bearer $LLMTR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "Flat vector icon of a paper plane, centered, isolated with no background",
    "background": "transparent",
    "output_format": "png",
    "size": "1024x1024",
    "quality": "medium"
  }'
# "background": "transparent" with "output_format": "jpeg" returns 400 invalid_request:
# transparent background requires output_format png or webp

Ruta sin versión preliminar y precios de gpt-image-2

La guía de generación de imágenes de OpenAI describe fondos transparentes con background transparent y output_format png o webp, y menciona también gpt-image-2.5-sunburst y gpt-image-2.5-flare. Esos dos modelos no están en el catálogo de LLMTR el 2026-10-06; en LLMTR la transparencia se obtiene con gpt-image-2.

Como la función es preliminar, la calidad y el comportamiento pueden cambiar. Para recursos con bordes exactos sigue disponible una segunda ruta: genera con background opaque, pide en el prompt un color de fondo plano y sólido, usa output_format png y elimina después ese fondo en tu propio pipeline de imágenes. En LLMTR, los precios por 1M tokens son: entrada de texto 5,00 $, entrada de imagen 8,00 $ y salida de imagen 30,00 $. Como el cobro es por tokens, el coste por imagen depende de size y quality.

Empezar en LLMTR: cuenta, crédito, clave y primera solicitud

Paso 1: crea una cuenta en llmtr.com y verifica tu correo electrónico. Paso 2: recarga crédito desde el Dashboard mediante el checkout seguro. El margen de plataforma del 8% se añade una sola vez, sobre la cantidad de recarga solicitada; por ejemplo, un crédito de 10,00 $ se cobra 10,80 $. El margen no se añade a los precios de los modelos: cada llamada de API se descuenta al precio del catálogo.

Paso 3: crea una clave de API en Dashboard > API Keys. La clave en bruto se muestra una sola vez; guárdala como variable de entorno, por ejemplo LLMTR_API_KEY. Paso 4: envía la primera solicitud a https://llmtr.com/v1 con cualquier SDK compatible con OpenAI, cambiando solo base_url y api_key. El uso y el gasto por clave aparecen en la página de uso del Dashboard. La misma clave y el mismo saldo de crédito sirven para todos los modelos del catálogo; para cambiar de modelo, modifica el valor model.

Configurar gpt-image-2 en LLMTR

Prepara una cuenta, añade crédito, crea una clave y envía la primera solicitud al endpoint compatible con OpenAI.

1. Crear cuenta. Crea una cuenta en llmtr.com y verifica tu correo electrónico.
2. Recargar crédito. Entra en el Dashboard y recarga crédito mediante el checkout seguro. El margen de plataforma del 8% se añade una sola vez; un crédito de 10,00 $ se cobra 10,80 $.
3. Crear clave de API. En Dashboard > API Keys, crea una clave de API. La clave en bruto se muestra solo una vez; guárdala como LLMTR_API_KEY.
4. Enviar primera solicitud. Configura base_url como https://llmtr.com/v1 y api_key, y envía la primera solicitud a https://llmtr.com/v1/images/generations con cualquier SDK compatible con OpenAI. La misma clave y el mismo saldo sirven para todos los modelos; cambia el valor model para cambiar de modelo.

Frequently asked questions

¿Por qué gpt-image-2 devuelve 400 al pedir un fondo transparente?

OpenAI habilitó los fondos transparentes para gpt-image-2 como versión preliminar el 20 de agosto de 2026; el 400 es el comportamiento anterior. Si aún lo ves, revisa output_format: transparent funciona con png y webp, y jpeg devuelve 400 invalid_request.

¿Cómo obtengo un PNG transparente con gpt-image-2?

Envía background transparent con output_format png. Como la función es preliminar, generar sobre un fondo sólido y eliminarlo después en tu propio pipeline sigue siendo una segunda ruta.

¿Qué valores acepta background en gpt-image-2?

Acepta opaque, auto y transparent. transparent requiere output_format png o webp; con jpeg devuelve 400.

Artículos relacionados

• xAI API: grok-imagine-image-quality, aspect_ratio y b64_json

• Guía de generación de imágenes
• Catálogo de modelos
• Precios