dall-e-3, el modelo con mayor capacidad de renderizado de texto gpt-image-1, la última generación gpt-image-2, así como la serie de modelos nano-banana / nano-banana-2 / nano-banana-pro accesibles a través de la misma interfaz. Todos ellos pueden generar imágenes de alta calidad basadas en descripciones de texto.
Este documento describe principalmente el proceso de uso de la API de Generación de Imágenes de OpenAI, con la cual podemos utilizar fácilmente las funcionalidades de generación de imágenes de la serie OpenAI.
Proceso de Solicitud
Para usar la API de Generación de Imágenes de OpenAI, primero puede ir a la página OpenAI Images Generations API y hacer clic en el botón “Acquire” para obtener las credenciales necesarias para realizar solicitudes:
Si aún no ha iniciado sesión o registrado, será redirigido automáticamente a la página de inicio de sesión para registrarse e iniciar sesión; después de esto, volverá automáticamente a la página actual.
Al solicitar por primera vez, se otorgará un crédito gratuito para usar la API sin costo.
Modelo GPT-Image-2
gpt-image-2 es el modelo de generación de imágenes de nueva generación lanzado por OpenAI, que presenta mejoras claras en comparación con dall-e-3 y gpt-image-1 en los siguientes aspectos:
- Mejor capacidad para seguir instrucciones: Puede comprender con precisión instrucciones estructuradas complejas como composición, conteo y relaciones de posición.
- Renderizado de texto más claro: En escenarios como carteles, menús, infografías y logotipos, el texto en inglés y los números casi no presentan errores.
- Mayor riqueza en la expresión de estilos: Soporta de forma nativa múltiples estilos como retratos cinematográficos, carteles vintage, ilustraciones infantiles, fotografía de productos e infografías.
- Soporte nativo para múltiples proporciones + alta resolución: Cubre 5 proporciones (1:1, 4:3, 3:4, 16:9, 9:16) con 3 niveles de resolución (1K / 2K / 4K).
model en gpt-image-2. La URL devuelta en el resultado es un enlace permanente alojado en platform.cdn.acedata.cloud, que puede abrirse directamente en el navegador o incrustarse en páginas web.
Valores soportados para size
gpt-image-2 solo verifica el formato de size; siempre que no sea auto o cadena vacía, debe coincidir con WIDTHxHEIGHT (por ejemplo, 1024x1024, 2048x1152, 800x600); cualquier otro formato devolverá un error 400. Todas las dimensiones (1K / 2K / 4K / personalizadas) se cobran por imagen generada, sin recargo por tamaño.
Restricciones estrictas de la plataforma para tamaños personalizados: ancho y alto deben ser múltiplos de 16, el lado largo ≤ 3840, y el total de píxeles ≤ 8,294,400. Si excede, será rechazado con un código 4xx.
| Proporción | Recomendado 1K | Recomendado 2K | Recomendado 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 4:3 | 1536x1024 | 2048x1536 | 3264x2448 |
| 3:4 | 1024x1536 | 1536x2048 | 2448x3264 |
| 16:9 | 1792x1024 | 2048x1152 | 3840x2160 |
| 9:16 | 1024x1792 | 1152x2048 | 2160x3840 |
También puede enviarsize: "auto"o omitir el camposize, en cuyo caso el modelo seleccionará el tamaño predeterminado automáticamente. En la resolución 1K, la salida no garantiza una alineación exacta de píxeles — si envía1024x1024, puede recibir1254x1254, manteniendo la proporción. Si vuelve a enviar esta dimensión comosize, el cobro es el mismo. La llamada en 4K suele tardar entre 4 y 8 minutos; se recomienda usar el mecanismo decallback_urlpara llamadas asíncronas.
Sobre el parámetroA continuación, algunos ejemplos reales para apreciar intuitivamente las capacidades denActualmentegpt-image-2no soportan > 1: este parámetro será ignorado silenciosamente; ya sea que envíen=1on=10, solo devolverá 1 imagen por solicitud y cobrará por 1 imagen. Si necesita varias imágenes candidatas, debe realizar múltiples solicitudes concurrentes (se recomienda usar diferentespromptoseedpara evitar imágenes muy similares). Esta restricción también aplica paragpt-image-1/gpt-image-1.5y la serienano-banana.dall-e-2es el único modelo que soportan > 1de forma nativa;dall-e-3solo soportan = 1.
gpt-image-2.
Escenario 1: Retrato cinematográfico
En el prompt puede usar términos cinematográficos (película de 35mm, poca profundidad de campo, luces de neón, etc.) para controlar con precisión la atmósfera y textura. Código de ejemplo en Python:
Escenario 2: Cartel de viaje vintage (con renderizado de texto)
gpt-image-2 tiene un rendimiento estable en tipografía y maquetación, ideal para generar carteles, menús, tarjetas con texto.

AMALFI y ITALIA 1958 claros y correctos.
Escenario 3: Composición compleja y conteo
Este prompt prueba la capacidad del modelo para seguir instrucciones estructuradas de cantidad y posición.
dall-e-3.
Escenario 4: Estilo ilustración (horizontal)
Especificando medios artísticos y palabras clave de emoción, se puede guiar al modelo para producir ilustraciones estilizadas.
Asíncrono y Callback
La llamada agpt-image-2 suele tardar entre 60 y 90 segundos. Si no desea mantener la conexión abierta, puede usar el mecanismo de callback asíncrono callback_url descrito más adelante; el proceso es idéntico al de otros modelos.
Serie de Modelos Nano Banana
La serienano-banana es un modelo de generación de imágenes basado en Gemini, accesible a través de la misma interfaz /openai/images/generations sin cambiar el endpoint, solo cambiando el campo model a cualquiera de los siguientes:
| Modelo | Costo (Créditos / llamada) | Escenario de uso |
|---|---|---|
nano-banana | 0.14 | Generación de imágenes estándar, más rápido y económico |
nano-banana-2 | 0.28 | Mejora notable en calidad y detalle |
nano-banana-pro | 0.35 | Modelo insignia, mejor composición, detalle y texto |
Importante: rango de parámetros soportados Nano Banana se integra mediante una capa adaptadora al protocolo OpenAI y, comparado congpt-image-*, solo soporta los parámetros:model,prompt,size.
sizese mapea internamente aaspect_ratiosegún la tabla siguiente; tamaños no listados se degradan a1:1:
1024x1024/512x512/256x256→1:11792x1024→16:91024x1792→9:16- No soporta
n,quality,style,response_format,background,output_format; si se envían, se ignoran.- La estructura de respuesta sigue el formato OpenAI (
data[].url), perocreatedes siempre0, no devuelveb64_json, yrevised_promptsiempre es igual al prompt original.
Llamada básica
url:

Actualización al modelo insignia nano-banana-pro
Solo cambie model a nano-banana-pro, los demás parámetros permanecen iguales:

Callback asíncrono
El mecanismo de callbackcallback_url también es válido para nano-banana, el proceso es idéntico al de otros modelos, ver la sección Callback asíncrono a continuación.
Uso básico
Luego puede rellenar los campos correspondientes en la interfaz, como se muestra:
authorization, que puede seleccionar directamente del menú desplegable; model, que es la categoría del modelo OpenAI DALL-E que desea usar (aquí principalmente un modelo, consulte los detalles de los modelos disponibles); y finalmente prompt, que es la descripción para generar la imagen.
También puede notar que a la derecha se genera el código de llamada correspondiente, que puede copiar y ejecutar directamente o hacer clic en el botón “Try” para probar.

created: ID único para esta tarea de generación de imagen.data: contiene la información del resultado de la imagen generada.
data, el campo url es el enlace a la imagen generada, como se muestra:

Parámetro de calidad de imagen quality
A continuación se explica cómo configurar parámetros detallados para la generación de imágenes. El parámetro de calidad quality tiene dos opciones: standard para imágenes estándar, y hd para imágenes con detalles más finos y mayor coherencia.
Ejemplo configurando quality a standard:


quality en standard es:

hd se obtiene una imagen con detalles más finos y mayor coherencia:

Parámetro de tamaño de imagen size
También puede configurar el tamaño de la imagen generada.
Ejemplo configurando tamaño a 1024x1024:


1024x1024:

1792x1024 se obtiene:
Se observa claramente la diferencia de tamaño. Puede configurar más tamaños, consulte la documentación oficial para más detalles.
Parámetro de estilo de imagen style
El parámetro style tiene dos opciones: vivid para imágenes más vívidas, y natural para imágenes más naturales.
Ejemplo configurando style a vivid:


style en vivid:

style a natural se obtiene:

vivid genera imágenes más vivas que natural.
Parámetro de formato de enlace de imagen response_format
El parámetro response_format tiene dos opciones: b64_json para codificar la imagen en Base64, y url para obtener un enlace directo a la imagen.
Ejemplo configurando response_format a url:


response_format en url es Imagen URL, accesible directamente, con contenido como se muestra:

response_format a b64_json se obtiene la imagen codificada en Base64, ejemplo:
Callback asíncrono
Dado que la generación de imágenes con la API de OpenAI puede tardar un tiempo considerable, mantener la conexión HTTP abierta consume recursos del sistema. Por ello, esta API también soporta callbacks asíncronos. El flujo es: el cliente envía la solicitud incluyendo un campo adicionalcallback_url. La API responde inmediatamente con un resultado que incluye un task_id que identifica la tarea. Cuando la tarea termina, el resultado con la imagen generada se envía mediante un POST JSON al callback_url especificado, incluyendo también el task_id para relacionar la respuesta con la solicitud.
Ejemplo práctico:
El webhook callback es un servicio que recibe solicitudes HTTP; el desarrollador debe reemplazarlo con la URL de su propio servidor HTTP. Para demostración, se usa el sitio público https://webhook.site/, que genera una URL de webhook, como se muestra:
Copie esta URL, por ejemplo https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab, y úsela como webhook.
Luego configure el campo callback_url con esta URL y envíe la solicitud:
task_id y el campo data con el mismo resultado que en la llamada síncrona, permitiendo relacionar la respuesta con la tarea.
Manejo de errores
Al llamar a la API, si ocurre un error, la API devolverá un código y mensaje de error correspondiente. Por ejemplo:400 token_mismatched: Solicitud incorrecta, posiblemente por parámetros faltantes o inválidos.400 api_not_implemented: Solicitud incorrecta, posiblemente por parámetros faltantes o inválidos.401 invalid_token: No autorizado, token de autorización inválido o faltante.429 too_many_requests: Demasiadas solicitudes, ha excedido el límite de tasa.500 api_error: Error interno del servidor.

