GPT Image 2
Descripción General
GPT Image 2 es el último modelo de generación de imágenes de OpenAI, optimizado para salida de alta resolución, proporciones flexibles y renderizado con control de calidad. Soporta tanto generación texto-a-imagen como edición image-to-image con una o múltiples imágenes de referencia.
Mejor para: creatividades de marketing, composiciones ultra anchas / verticales, renders con resolución personalizada e imágenes de producto que requieren detalle nítido.
Aviso: mantén un modelo de respaldo en producción.
gpt-image-2está recibiendo mucho tráfico actualmente y el upstream de OpenAI es ocasionalmente inestable, lo que puede provocar respuestas más lentas o errores transitorios. Para tráfico de producción recomendamos mantener un modelo Gemini configurado como respaldo: preferentementegemini-3-pro-image-previewpor calidad, ogemini-3.1-flash-image-previewcuando importan la latencia y el costo.
Capacidades
| Característica | Soporte |
|---|---|
| Texto a Imagen | ✅ Soportado |
| Edición de Imagen (image-to-image) | ✅ Soportado (solo URL) |
| Generación por Lotes | ⚠️ Solo se admite n=1 actualmente |
| Resolución Personalizada | ✅ Hasta 3840 de borde largo |
| Niveles de Calidad | ✅ low · medium · high · auto |
Precios
Créditos por imagen, según tamaño de salida × calidad. La calidad auto se factura al mismo precio que high.
| Nivel | Borde más largo | low | medium | high / auto |
|---|---|---|---|---|
| 1K | ≤ 1536 px | 1 | 4 | 14 |
| 2K | ≤ 2048 px | 2 | 17 | 67 |
| 4K | ≤ 3840 px | 4 | 34 | 133 |
Aviso de precios. Los niveles
medium/highestán a aproximadamente 80% del precio oficial por imagen de OpenAI (fuente). El nivellowse factura con un mínimo fijo de 1 crédito / imagen debido al redondeo de granularidad de créditos, lo que puede ser superior al 80% del precio oficial para generaciones muy pequeñas. Una solicitud consize=autose factura como nivel 1K por defecto;quality=autose trata comohigh. El cargo final =valor de la matriz × n.
Ejemplos
| Solicitud | Nivel | Calidad | Créditos / imagen |
|---|---|---|---|
size: "auto", quality: "auto" (predet.) | 1K | high | 14 |
size: "1024x1024", quality: "low" | 1K | low | 1 |
size: "1536x1024", quality: "medium" | 1K | medium | 4 |
size: "2048x1152", quality: "high" | 2K | high | 67 |
size: "3840x2160", quality: "high" | 4K | high | 133 |
Tamaños Soportados
Puedes pasar uno de los presets populares o especificar un WIDTHxHEIGHT totalmente personalizado.
Presets Populares
1024x1024 · 1536x1024 · 1024x1536 · 2048x2048 · 2048x1152 · 3840x2160 · 2160x3840 · auto
Dimensiones Personalizadas
Los valores WIDTHxHEIGHT personalizados deben cumplir todo lo siguiente:
- Borde largo no mayor a 3840px
- Ancho y alto deben ser múltiplos de 16
- La proporción no debe exceder 3:1 (borde largo ≤ 3 × borde corto)
- Total de píxeles entre 655,360 y 8,294,400
Si size se omite o se establece como auto, el modelo elige las dimensiones más apropiadas para tu prompt.
Opciones de Calidad
| Valor | Descripción |
|---|---|
low | Generación más rápida, menor fidelidad |
medium | Equilibrio entre velocidad y calidad |
high | Máximo detalle y fidelidad |
auto | El modelo elige el mejor nivel (predeterminado) |
Inicio Rápido
Reemplaza YOUR_API_KEY con tu API key real. ¿Aún no tienes una? Créala aquí.
curl -X POST "https://api.nanobananaapi.dev/v1/images/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Un gato atigrado naranja con bufanda naranja abrazando una nutria, estilo de ilustración cálida",
"n": 1,
"size": "3840x2160",
"quality": "high"
}'const res = await fetch('https://api.nanobananaapi.dev/v1/images/generate', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'gpt-image-2',
prompt:
'Un gato atigrado naranja con bufanda naranja abrazando una nutria, estilo de ilustración cálida',
n: 1,
size: '3840x2160',
quality: 'high',
}),
});
const result = await res.json();
console.log(result.data.url);import requests
res = requests.post(
'https://api.nanobananaapi.dev/v1/images/generate',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
json={
'model': 'gpt-image-2',
'prompt': 'Un gato atigrado naranja con bufanda naranja abrazando una nutria, estilo de ilustración cálida',
'n': 1,
'size': '3840x2160',
'quality': 'high',
},
timeout=60,
)
result = res.json()
print(result['data']['url'])Referencia de Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
model | string | Sí | Debe ser gpt-image-2 |
prompt | string | Sí | Descripción de texto, hasta 2000 caracteres |
image | string | string[] | Solo edición | URL pública o array de URLs públicas de las imágenes de referencia. gpt-image-2 NO acepta base64 / data: URLs — sube el archivo a un CDN y pasa la URL. Máximo 14 imágenes. |
n | integer | No | Cantidad de imágenes a generar. Actualmente solo se admite 1 (predeterminado 1); las solicitudes con n > 1 son rechazadas. Llama a la API varias veces si necesitas más. |
size | string | No | Preset popular, WIDTHxHEIGHT personalizado o auto (predeterminado auto) |
quality | string | No | low · medium · high · auto (predeterminado auto) |
Edición de Imagen (image-to-image)
Para editar o componer a partir de imágenes de referencia, envía la solicitud a /v1/images/edit (o al endpoint compatible con OpenAI /api/v1/images/edits) con el campo image configurado como una o más URLs públicas. gpt-image-2 no acepta base64 / data: URLs.
curl -X POST "https://api.nanobananaapi.dev/v1/images/edit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Reemplaza el fondo con una montaña nevada al atardecer, conservando el sujeto",
"image": "https://cdn.example.com/source.png",
"n": 1,
"size": "auto",
"quality": "high"
}'const res = await fetch('https://api.nanobananaapi.dev/v1/images/edit', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'gpt-image-2',
prompt: 'Compone estos dos productos en un fondo de estudio limpio',
image: [
'https://cdn.example.com/product-a.png',
'https://cdn.example.com/product-b.png',
],
n: 1,
size: '2048x1152',
quality: 'high',
}),
});
const result = await res.json();
console.log(result.data.url);Mejores Prácticas
- Comienza con
auto: Deja que el modelo elija el tamaño y la calidad para el mejor equilibrio, luego ajusta. - Dimensiones personalizadas: Elige múltiplos de 16 cercanos a un preset popular para evitar rechazos.
- Límite de proporción: Para banners ultra anchos, mantén la proporción ≤ 3:1 (ej.
3072x1024, no3840x1024). - Longitud del prompt: Mantente bajo 2000 caracteres; los prompts concisos suelen producir resultados más nítidos.
Preguntas Frecuentes
¿gpt-image-2 soporta edición de imágenes?
Sí. Envía la solicitud a /v1/images/edit con image apuntando a una URL pública (o un array de URLs). gpt-image-2 no acepta base64 / data: URLs — sube primero el archivo a un CDN.
¿Por qué se rechaza mi tamaño personalizado? Las causas más comunes son: una dimensión que no es múltiplo de 16, un borde largo mayor a 3840, una proporción superior a 3:1, o un total de píxeles fuera del rango 655,360–8,294,400.
¿Cómo se calculan los créditos?
Se facturan según el nivel de tamaño (1K / 2K / 4K, inferido por el borde más largo) × calidad (low / medium / high; auto se cobra como high). Consulta la sección Precios. El cargo final = valor de la matriz × n. Todos los créditos están al 80% del precio oficial de la API de OpenAI.
Relacionados
- API Texto a Imagen — Referencia completa de la API de generación
- Gemini 3 Pro Image Preview — Calidad profesional de estudio
- Gemini 3.1 Flash Image Preview — Alta eficiencia con resoluciones extendidas
- Gemini 2.5 Flash Image — Máxima velocidad, costo más bajo