Familia Nano Banana
Los modelos de imagen Gemini de Google, cinco en total. Se recomienda llamarlos a través del endpoint nativo de Gemini, que permite controlar con precisión la relación de aspecto y la resolución; el endpoint compatible con OpenAI también funciona, pero solo admite parte de los parámetros.
Tareas habituales
Elección de modelo
- Tres niveles: 1K, 2K y 4K
- Relaciones de aspecto de 1:8 a 8:1; 2K y 4K tardan unos 2 minutos en nuestras mediciones
- Cuatro niveles de resolución, de 512 a 4K
- La mayor variedad de relaciones de aspecto, incluidas 1:8 y 8:1
- Tres niveles: 1K, 2K y 4K
- Razona antes de generar, por lo que tarda más
- Solo admite 1K
- Unos 5 segundos por imagen en nuestras mediciones; salida en JPEG
- Fijo en torno a 1K; no permite indicar la resolución
- Los proyectos existentes pueden seguir usándolo
google/gemini-nano-banana-2.1Más recientegoogle/gemini-3.1-flash-imageRecomendado para el día a díagoogle/gemini-3-pro-image4K, composiciones complejasgoogle/gemini-3.1-flash-lite-imageSolo admite 1Kgoogle/gemini-2.5-flash-imageGeneración anteriorPara los precios vigentes, consulte las páginas de los modelos: Nano Banana 2 , Nano Banana Pro . El cargo real se rige por el campo usageMetadata de la respuesta.
Elección de endpoint
Latencia y tiempo de espera
La API es síncrona. En nuestras mediciones, 1K tarda entre 5 y 20 segundos y 4K unos 30 segundos; 2K y 4K con Nano Banana 2.1 tardan unos 2 minutos. En horas punta tarda más. Pro razona antes de generar la imagen (la respuesta incluye thoughtsTokenCount), por lo que tarda más que Nano Banana 2 a la misma resolución. El tiempo de espera predeterminado habitual de 60 segundos no basta para las peticiones en 4K ni en horas punta; si el cliente se desconecta, la petición se factura igualmente.
Estructura de la respuesta
{
"candidates": [{
"content": {
"parts": [{ "inlineData": { "mimeType": "image/png", "data": "iVBORw0KGgo…" } }],
"role": "model"
},
"finishReason": "STOP"
}],
"modelVersion": "google/gemini-3-pro-image",
"usageMetadata": {
"promptTokenCount": 7,
"candidatesTokenCount": 2000,
"candidatesTokensDetails": [{ "modality": "IMAGE", "tokenCount": 2000 }],
"thoughtsTokenCount": 211,
"totalTokenCount": 2218
}
}- La imagen está en el elemento de
partsque contieneinlineData, que no es necesariamente el primero: puede ir precedido de texto. Recorrapartspara encontrarlo. - El valor del elemento
IMAGEencandidatesTokensDetailses el número de tokens de la imagen de salida. En nuestras mediciones, 1.120 para 1K y 2.000 para 4K con Pro. thoughtsTokenCountsolo aparece en las respuestas de Pro e indica los tokens de razonamiento previos a la generación de la imagen.
Documentación oficial
La documentación oficial describe el comportamiento al llamar directamente a Google; al llamar a través de OfoxAI, prevalecen las conclusiones medidas en esta página.
- Gemini API · Generación de imágenes
- Gemini API · Relación de aspecto y resolución en la generación de imágenes
- OfoxAI · Protocolo nativo de Gemini generateContent
Preguntas frecuentes
¿Cómo genero imágenes en 4K con Nano Banana Pro?
Use el endpoint nativo de Gemini y envíe imageSize: "4K" en generationConfig.imageConfig, indicando además la relación de aspecto con aspectRatio. En nuestras mediciones, 4K en 16:9 produjo 5504x3072, unos 16 MB, en unos 33 segundos. El endpoint compatible con OpenAI no admite imageSize: enviar image_size devuelve 400.
¿Qué relaciones de aspecto admite Nano Banana 2?
Diez habituales: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 y 21:9; además, admite cuatro relaciones extremadamente anchas o altas: 1:4, 4:1, 1:8 y 8:1. Cualquier relación fuera de la lista devuelve 400 Request contains an invalid argument.
¿Nano Banana Pro admite 1:8 o 4:1?
No. Las relaciones 1:4, 4:1, 1:8 y 8:1 solo las admiten Nano Banana 2.1, Nano Banana 2 y Nano Banana 2 Lite; si necesita imágenes extremadamente altas o anchas, use uno de estos tres modelos.
¿imageSize se escribe 4K o 4k?
Se recomienda usar mayúsculas (1K, 2K, 4K), como en la documentación oficial de Google. En nuestras mediciones, OfoxAI también acepta minúsculas. El nivel 512 no lleva K y solo lo admite Nano Banana 2.
¿Cómo indico la relación de aspecto de Nano Banana con el endpoint compatible con OpenAI?
Use aspect_ratio en el nivel superior, por ejemplo "16:9". Este endpoint no admite parámetros de resolución; para 2K o 4K, use imageConfig.imageSize en el endpoint nativo de Gemini.
¿Nano Banana puede generar varias imágenes a la vez?
No: cada petición genera una imagen. Si necesita varias, envíe varias peticiones en paralelo, teniendo en cuenta los límites de velocidad.
¿Qué tiempo de espera conviene configurar para Nano Banana?
Se recomiendan 300 segundos o más. En nuestras mediciones, 1K tarda entre 5 y 20 segundos, 4K unos 30 segundos, y 2K y 4K con Nano Banana 2.1 unos 2 minutos; en horas punta tarda más. Pro razona antes de generar, por lo que tarda más que Nano Banana 2.