AIFreeAPI Logo

Fondo transparente con GPT Image 2: API, PNG y canal alfa

A
5 min readDesarrollo de IA

Una vista previa cuadriculada no demuestra que el archivo sea transparente. Hay que pedir el fondo y el formato correctos, decodificar la respuesta y revisar los valores alfa.

Fondo transparente con GPT Image 2: petición API, formatos PNG y WebP, insignia de sol y comprobación del canal alfa

GPT Image 2 ya permite solicitar imágenes con fondo transparente mediante la API de OpenAI. En septiembre de 2026 la función sigue en preview. Para usarla, la petición debe incluir background: "transparent", la salida debe ser PNG o WebP y el archivo final debe conservar píxeles con alfa después de cualquier conversión.

Es una diferencia importante: PNG es un formato capaz de guardar transparencia, no una garantía de que la imagen la contenga. Incluso una cuadrícula gris y blanca puede estar dibujada dentro de una imagen totalmente opaca. La aceptación debe basarse en el archivo, no solo en lo que muestra un visor.

La petición mínima tiene dos parámetros inseparables

La guía de generación de imágenes de OpenAI presenta Image API como la opción directa para generar o editar una imagen. La guía oficial de GPT Image concreta el uso del fondo transparente en gpt-image-2:

  • background debe valer transparent, no dejarse en auto cuando el alfa sea obligatorio.
  • output_format debe ser png o webp. JPEG no admite esta transparencia.
  • En PNG se omite output_compression; en WebP puede configurarse compresión.
  • El prompt debe pedir un sujeto aislado y excluir escena, fondo sólido, cuadrícula y sombras que no deban formar parte del recurso.
  • Cada edición posterior debe volver a exigir que se conserve el fondo transparente.

El prompt ayuda a definir el recorte, pero no sustituye el parámetro background. Si solo se escribe “sin fondo”, el modelo puede interpretar la frase como una decisión visual y producir un fondo claro o una cuadrícula dentro de la propia imagen.

Generar, decodificar y guardar sin cambiar el formato

Este ejemplo en JavaScript crea una insignia reutilizable y escribe los bytes decodificados en un PNG:

javascript
import OpenAI from "openai"; import { writeFile } from "node:fs/promises"; const client = new OpenAI(); const image = await client.images.generate({ model: "gpt-image-2", prompt: [ "Create one centered ceramic sun badge as an isolated asset.", "Fully transparent background with a clean, crisp silhouette.", "No scene, solid backdrop, checkerboard, border, or cast shadow." ].join(" "), background: "transparent", output_format: "png", size: "1024x1024", quality: "medium" }); const bytes = Buffer.from(image.data[0].b64_json, "base64"); await writeFile("sun-badge.png", bytes);

Una respuesta HTTP correcta solo confirma que la operación terminó. Conviene comprobar por separado que el contenido base64 se decodificó, que la firma real corresponde al formato elegido y que existen valores alfa útiles.

Si se solicita WebP, también deben cambiar la extensión y el MIME al guardar. Renombrar bytes WebP como .png puede funcionar en algún navegador, pero suele fallar en gestores de contenido, bibliotecas de imágenes o servicios de miniaturas.

Proceso en cuatro pasos: solicitar fondo transparente, decodificar base64, validar el formato PNG y comprobar la distribución del canal alfa.
Proceso en cuatro pasos: solicitar fondo transparente, decodificar base64, validar el formato PNG y comprobar la distribución del canal alfa.

En una edición, hay que proteger el objeto

Para quitar el fondo de una foto de producto existente, se usa la edición de Image API. El encargo debe separar lo que cambia de lo que permanece: retirar el entorno no autoriza a redibujar la geometría, los colores, las proporciones o el texto de la etiqueta.

text
Aísla el producto sobre un fondo completamente transparente. Conserva exactamente su forma, proporciones, colores y texto de la etiqueta. Mantén un contorno limpio, sin halos ni contaminación de color. No añadas escena, fondo sólido, cuadrícula ni sombra.

Al volver a editar la imagen, se repite la condición de transparencia. Un cambio pequeño en el envase genera una salida nueva; el fondo anterior no queda bloqueado de forma automática.

Cabello, pelo, cristal, humo y resplandores requieren píxeles semitransparentes en el borde. Por eso no basta con preguntar si existe algún alfa. Un recurso importante debe verse sobre un color muy claro y otro muy oscuro para descubrir halos blancos o negros.

Comprobar el alfa con un script corto

Insignia de sol transparente sobre fondos claro, oscuro y de color, con ampliación del borde, histograma alfa, MIME y firma PNG.
Insignia de sol transparente sobre fondos claro, oscuro y de color, con ampliación del borde, histograma alfa, MIME y firma PNG.

Pillow permite contar píxeles transparentes, semitransparentes y opacos del archivo ya guardado:

python
from PIL import Image image = Image.open("sun-badge.png").convert("RGBA") alpha = image.getchannel("A") histogram = alpha.histogram() transparentes = histogram[0] semitransparentes = sum(histogram[1:255]) opacos = histogram[255] print({ "transparentes": transparentes, "semitransparentes": semitransparentes, "opacos": opacos, }) if transparentes == 0 and semitransparentes == 0: raise ValueError("El archivo no contiene transparencia utilizable")

El resultado confirma la presencia de transparencia, no la calidad del recorte. En un icono pequeño centrado debería quedar una zona amplia completamente transparente. En humo o vidrio puede dominar el alfa intermedio. No existe un porcentaje único que sirva como criterio para todos los recursos.

Para detectar una cuadrícula dibujada, se coloca la imagen sobre negro, blanco y un color intenso. Si la cuadrícula se mantiene idéntica, pertenece al contenido RGB; una zona realmente transparente deja ver cada color inferior.

Localizar el punto donde se perdió la transparencia

ResultadoCausa probableComprobación útil
El PNG tiene un rectángulo blancoFalta background o un intermediario lo descartóCuerpo final enviado y petición mínima directa
Se recibe JPEGLa solicitud o una conversión cambió el formatoMIME, firma del archivo y código de guardado
Aparece una cuadrícula fijaEl modelo dibujó la representación de transparenciaPlano alfa y exclusiones del prompt
El fondo vuelve tras editarLa nueva instrucción no conservó la transparenciaÚltima petición de edición
Hay borde blanco sobre oscuroEl borde se mezcló con un fondo claroComposición sobre fondos claros y oscuros
El original funciona y la miniatura noEl redimensionador o CDN eliminó el alfaArchivo final entregado al usuario

En una pasarela compatible con OpenAI, aceptar el mismo nombre de parámetro no demuestra que lo reenvíe ni que devuelva el mismo formato. Para diagnosticarla hacen falta el modelo real, el cuerpo final, el MIME, la firma de los bytes decodificados y las estadísticas alfa. Es posible recibir un 200 con una imagen opaca si el servicio ignora un campo desconocido.

La salida nativa no elimina todos los retoques

La transparencia nativa reduce pasos en iconos, pegatinas, elementos de interfaz y productos de contorno claro. Al ser preview, no garantiza bordes perfectos, fidelidad de etiquetas ni uniformidad en un catálogo completo. El cabello fino, los materiales translúcidos y los envases de marca todavía necesitan una muestra de control y, cuando falle, corrección de máscara o eliminación de fondo independiente.

Si antes necesitas decidir entre Image API, la herramienta de imágenes de Responses, Codex y una pasarela externa, consulta la guía de rutas para GPT Image 2 API. Para un único recorte reutilizable, basta una disciplina más sencilla: pedir fondo y formato de forma explícita, conservar el archivo original y repetir la comprobación alfa después de cada transformación.