API Gemini 3 Pro Image (antes Preview): Precios, Resoluciones y Guía de Uso
Guía completa de la API Gemini 3 Pro (Nano Banana Pro): evolución al ID estable Google GA, alias de Pixapi, sintaxis de aspect ratio en curl y ahorro vs tarifas oficiales.

La API Gemini 3 Pro Image (antes Preview) —conocida popularmente como Nano Banana Pro— es el generador visual más avanzado de Google en la familia Gemini y el modelo de referencia para equipos que pasan de fase de prototipo a producción comercial.
Esta guía detalla la transición hacia la denominación oficial GA de Google, el enrutamiento de compatibilidad en Pixapi, los identificadores por resolución y las pautas de integración.
¿Qué es Gemini 3 Pro Image?
Gemini 3 Pro Image (gemini-3-pro-image) es el modelo de nivel profesional de Google para generación y edición de imágenes. Acepta peticiones de texto a imagen e imagen a imagen, genera hasta 4096×4096 (4K) y destaca en ediciones fotográficas que preservan la composición original con gran naturalidad.
Puntos clave sobre nomenclatura e integración:
- Evolución a Google GA: Google utilizó inicialmente
gemini-3-pro-image-previewen fase beta, consolidando en su lanzamiento comercial el nombre canónicogemini-3-pro-image. - Compatibilidad en Pixapi: Pixapi prioriza el ID oficial
gemini-3-pro-imagey soporta el alias clásicogemini-3-pro-image-preview, garantizando cero roturas en despliegues existentes. - Nano Banana Pro: Es el nombre coloquial en comunidades técnicas comúnmente asociado a Gemini 3 Pro Image.
Precios de la API Gemini 3 Pro Image
Pixapi factura mediante créditos donde 1 crédito = $0.01 USD:
| Resolución | Model ID Principal | Alias Compatible | Precio Pixapi | Créditos | Tarifa Oficial Google | Ahorro vs Oficial |
|---|---|---|---|---|---|---|
| 1024×1024 (1K) | gemini-3-pro-image | gemini-3-pro-image-preview | $0.08 / imagen | 8 | ~$0.134 | ~40.3% |
| 2048×2048 (2K) | gemini-3-pro-image-2k | gemini-3-pro-image-preview-2k | $0.08 / imagen | 8 | ~$0.134 | ~40.3% |
| 4096×4096 (4K) | gemini-3-pro-image-4k | gemini-3-pro-image-preview-4k | $0.16 / imagen | 16 | ~$0.240 | ~33.3% |
Precios verificados en agosto de 2026. La resolución 2K mantiene el mismo coste que 1K ($0.08), siendo la opción recomendada para producción web. En 4K, el precio oficial de Google se sitúa en ~$0.24, mientras que en Pixapi se obtiene por $0.16 (~33.3% de ahorro). Consulta los paquetes disponibles en la página de precios.
Catálogo de la familia Gemini en Pixapi:
| Modelo | Model ID Principal | Alias Compatible | Precio desde |
|---|---|---|---|
| Gemini 3 Pro Image | gemini-3-pro-image | gemini-3-pro-image-preview | $0.08 / imagen |
| Gemini 3.1 Flash Image | gemini-3.1-flash-image | gemini-3.1-flash-image-preview | $0.04 / imagen |
| Gemini 3.1 Flash Lite Image | gemini-3.1-flash-lite-image | — | $0.02 / imagen |
| Gemini 2.5 Flash Image | gemini-2.5-flash-image | nano-banana | $0.02 / imagen |
Cómo realizar llamadas a la API
Crea tu clave Bearer en el panel de Pixapi y realiza peticiones HTTP estándar. Aviso: el campo size define la relación de aspecto (1:1, 16:9, etc.), mientras que la resolución (1K/2K/4K) se selecciona mediante el model ID.
1. Ejemplo de texto a imagen: render 2K cuadrado
curl -X POST https://api.pixapi.ai/v1/images/generations \
-H "Authorization: Bearer $PIXAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3-pro-image-2k",
"prompt": "Studio product photo of a ceramic coffee mug on linen, soft daylight",
"size": "1:1"
}'2. Ejemplo de edición de imágenes (Image Edits)
Para edición o cambios de fondo, envía la imagen base al endpoint de edits:
curl -X POST https://api.pixapi.ai/v1/images/edits \
-H "Authorization: Bearer $PIXAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3-pro-image",
"image": "https://example.com/input.jpg",
"prompt": "Replace the background with a marble countertop, keep the mug unchanged"
}'Los esquemas de respuesta y ratios soportados están documentados en la referencia de la API de generación de imágenes. Mantén siempre las claves de API en el servidor.
Cuándo elegir Pro frente a Flash
- Pro ($0.08): Activos finales, material publicitario, composiciones detalladas e imágenes principales.
- Flash ($0.04): Exploración rápida, variantes A/B y previsualizaciones donde la velocidad prime sobre el acabado definitivo.
- Flash Lite / 2.5 Flash ($0.02): Procesamiento masivo de bajo coste, miniaturas y filtros.
Un patrón habitual consiste en usar Flash para iterar con el usuario y Pro para renderizar la opción elegida en 2K o 4K.
Consejos prácticos de producción
- Usa 2K por defecto: 2K y 1K tienen el mismo precio ($0.08) en Pixapi; brinda mayor nitidez sin coste adicional.
- Utiliza 4K con moderación: 4K duplica el gasto ($0.16) y se reserva para displays de gran formato.
- Aprovecha el endpoint de edición: Enviar la imagen de referencia mantiene la geometría de cena de forma muy superior a describirla con texto.
Lecturas recomendadas
Preguntas frecuentes
¿Cuánto cuesta la API Gemini 3 Pro Image?
En Pixapi, Gemini 3 Pro cuesta 8 créditos ($0.08) por imagen en resoluciones 1K (1024px) y 2K (2048px), y 16 créditos ($0.16) en 4K (4096px). Comparado con la tarifa oficial de Google (~$0.134 en 1K–2K y ~$0.240 en 4K), el ahorro es del ~40.3% en 1K/2K y del ~33.3% en 4K.
¿Cuál es el model ID adecuado para llamar a Gemini 3 Pro?
Google ha formalizado el modelo bajo la nomenclatura GA oficial gemini-3-pro-image. Pixapi prioriza el ID estándar oficial gemini-3-pro-image y mantiene el alias gemini-3-pro-image-preview para compatibilidad hacia atrás. Para solicitar 2K o 4K, utiliza gemini-3-pro-image-2k o gemini-3-pro-image-4k.
¿Cómo se configuran el ratio y la resolución en Pixapi?
En Pixapi, el parámetro size define la relación de aspecto (como 1:1, 16:9, 9:16, 4:3), mientras que la resolución (1K, 2K, 4K) se indica en el model ID. Por ejemplo, model: "gemini-3-pro-image-2k" con size: "1:1" genera una imagen nítida en 2K cuadrado de 2048×2048.
¿Gemini 3 Pro Image es lo mismo que Nano Banana Pro?
Sí. Nano Banana Pro es el alias ampliamente adoptado por la comunidad para designar a Gemini 3 Pro Image de Google. La variante ligera y rápida (Gemini 3.1 Flash Image) se denomina frecuentemente Nano Banana 2.
¿Cuándo conviene elegir Pro frente a Gemini 3.1 Flash?
Elige Pro cuando la calidad final de la imagen sea prioritaria frente a la latencia: imágenes de portada, material publicitario o detalles finos. Usa Gemini 3.1 Flash ($0.04 por imagen) para borradores rápidos, pruebas A/B y flujos de alto volumen.
