Clave API de Nano Banana gratis: cómo obtenerla y límites del nivel gratuito
Crear un token de la API de Nano Banana no cuesta nada, pero Google no ofrece nivel gratuito para ninguno de sus modelos de imagen. Este artículo explica el precio real por imagen, qué ocurre cuando la facturación está desactivada y las formas gratuitas de probar Nano Banana sin pagar por las llamadas a la API.
Puedes crear un token de la API de Nano Banana gratis en aproximadamente un minuto. No puedes usarlo para generar imágenes gratis. A fecha de octubre de 2026, la página de precios de Google no incluye nivel gratuito para ningún modelo Nano Banana, así que cada imagen solicitada a través de la API de Gemini se cobra desde la primera llamada. Ese solo hecho explica por qué tantos desarrolladores ven un error 429 en un token recién creado que parece perfectamente válido.
Este artículo separa lo que es gratis de lo que no lo es. Encontrarás los pasos exactos para crear el token, el ID de modelo y el precio de cada versión de Nano Banana, tres ejemplos de presupuesto, las reglas de cuota que hay detrás de los errores y las formas legítimas de probar el modelo sin pagar por las llamadas a la API. Todas las cifras se comprobaron con la documentación de Google en octubre de 2026. Los precios cambian, así que confírmalos en la página oficial de precios antes de fijar un presupuesto.
💡 Respuesta rápida: Crear un token es gratis. Llamar a Nano Banana a través de la API requiere una cuenta de facturación. Probar Nano Banana sin facturación significa usar una aplicación o una herramienta de navegador, no la API.
La respuesta corta
Lo que cuesta el token
Nada. La documentación de Google indica que los usuarios nuevos reciben automáticamente un proyecto predeterminado de Google Cloud y un token después de aceptar las Condiciones del servicio en Google AI Studio. No se necesita método de pago para obtener el token. El token solo identifica tu proyecto y no tiene cuota de imágenes propia, que es la parte que más gente pasa por alto.
Piensa en él como una tarjeta de biblioteca sin libros. La tarjeta es gratuita, y los estantes a los que da acceso, los modelos de imagen, son de pago.
Lo que cuestan las llamadas de imagen
Todos los modelos Nano Banana son de pago. El precio va desde $0.0336 por una imagen de 1K en el modelo más ligero hasta $0.24 por una imagen de 4K en el modelo Pro. Los modelos de texto de Google sí tienen cuotas de nivel gratuito y límites diarios de solicitudes, y esa reputación es la razón por la que tantos tutoriales prometen una API de imágenes gratuita. La promesa no se cumple para los modelos de imagen.
El resultado práctico es sencillo:
Los tokens gratuitos existen.
La generación de imágenes gratuita a través de la API no existe.
La generación gratuita a través de una aplicación o una herramienta de navegador sí existe.
Las secciones siguientes muestran cada vía en orden.
Google puede cambiar esto en cualquier momento, y los niveles gratuitos de otras familias de modelos ya han cambiado antes. No te fíes de la fecha de un tutorial. Abre la página de precios, busca la fila del ID de modelo que vas a llamar y lee tú mismo la celda de nivel gratuito. Si esa celda llega a mostrar una cuota en lugar de "No disponible", los consejos de este artículo cambian con ella.
Qué significa Nano Banana en la API
Nano Banana es el apodo de los modelos de imagen de Gemini de Google. El apodo abarca ya varias generaciones, y cada una tiene su propio ID de modelo, límite de resolución y precio. Llamar al ID equivocado es la forma más rápida de gastar de más, así que la tabla los enumera uno al lado del otro.
Los límites de resolución varían según el modelo. Nano Banana 2 Lite renderiza solo en 1K. Nano Banana 2 ofrece 512 px (0.5K), 1K, 2K y 4K. Nano Banana Pro ofrece 1K, 2K y 4K. Los tres modelos más recientes aceptan hasta 14 imágenes de referencia, y cada imagen generada lleva una marca de agua SynthID.
Cuál se ajusta a tu presupuesto
Borradores en volumen: usa Nano Banana 2 Lite, a unos 3.4 céntimos por imagen de 1K.
Trabajo diario: usa Nano Banana 2, que llega a 4K y admite 14 imágenes de referencia, por 6.7 céntimos en 1K.
Arte final: usa Nano Banana Pro, que Google describe como "la opción premium para las tareas visuales más complejas". Cuesta exactamente el doble que Nano Banana 2 en 1K ($0.134 frente a $0.067).
Código antiguo: las llamadas que apuntan al ID original se cobran a $0.039 por imagen.
Un flujo de trabajo viable usa dos etapas. Dibuja la composición con Nano Banana 2 Lite o en 0.5K hasta que el encuadre, la pose y la iluminación se vean bien. Después envía el prompt ganador, con sus imágenes de referencia, a Nano Banana Pro para el render final. Pagas el precio premium una vez por entregable en lugar de una vez por cada prueba.
Cómo obtener tu token
Créalo en AI Studio
Abre Google AI Studio e inicia sesión con una cuenta de Google.
Acepta las Condiciones del servicio. Se crean para ti un proyecto predeterminado de Google Cloud y un token.
Abre la lista de tokens y copia la cadena que pertenece al proyecto predeterminado.
Guárdala en una variable de entorno. Los SDK oficiales leen GEMINI_API_KEY o GOOGLE_API_KEY, y si existen ambas, GOOGLE_API_KEY tiene prioridad.
Revisa el plan que aparece para ese proyecto. Un proyecto sin facturación es la razón por la que más llamadas de imagen fallan después.
export GEMINI_API_KEY="paste-your-token-here"
La mayoría de la gente puede quedarse en el proyecto predeterminado. Un segundo proyecto solo sirve cuando quieres facturación y límites separados, por ejemplo uno para la web de un cliente y otro para tus experimentos personales. Recuerda que las cuotas pertenecen al proyecto, así que repartir el trabajo entre proyectos también reparte la factura.
Haz tu primera prueba
La documentación de Google muestra esta llamada mínima en Python. El cliente lee la variable de entorno por sí mismo, así que ninguna cadena aparece en el código.
from google import genai
import base64
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.1-flash-image",
input="A ripe banana on a wooden desk, morning window light",
)
with open("banana.png", "wb") as f:
f.write(base64.b64decode(interaction.output_image.data))
En un proyecto sin facturación, esta es exactamente la llamada que falla. En un proyecto con facturación, genera banana.png y cobra unos 6.7 céntimos.
Mantenlo fuera de Git
Google indica a los desarrolladores que traten el token como una contraseña. Si se filtra, otras personas pueden agotar tu cuota y acumular cargos en tu proyecto.
Nunca lo subas a un control de versiones.
Nunca lo incluyas en el código de una aplicación web o móvil, porque cualquiera puede extraer el código que se envía a un navegador.
Llama a la API desde un servidor que controles.
Si se filtra, genera un token nuevo, actualiza tu aplicación, desactiva el antiguo y luego revisa los registros de uso en busca de llamadas que no hiciste.
Por qué fallan las llamadas gratuitas
El muro de la facturación
Un token sin facturación detrás puede autenticarse, pero no puede pagar una imagen. Desarrolladores en los foros oficiales de Google informan de respuestas 429 al llamar a un modelo Nano Banana desde un proyecto gratuito, y el mensaje parece un problema de límite de velocidad, aunque la causa real es la falta de facturación.
Revisa estos puntos en orden:
Estado de la facturación: vincula una cuenta de facturación de Cloud al proyecto que es dueño del token.
ID de modelo: usa uno de los cuatro IDs de la tabla de arriba.
Imágenes por minuto: los modelos de imagen se cuentan en su propia unidad, que se explica más abajo.
Reinicio diario: los contadores se reinician a medianoche, hora del Pacífico.
Tres malos hábitos hacen perder un día de depuración:
Crear tokens adicionales en el mismo proyecto con la esperanza de obtener una cuota nueva.
Cambiar de red o de punto de conexión VPN, lo que no tiene efecto sobre una cuota vinculada a un proyecto.
Esperar al reinicio de medianoche, cuando el bloqueo real es la falta de una cuenta de facturación.
Primero arregla la facturación. Después, si las respuestas 429 continúan, trátalas como un problema de límite de velocidad y ralentiza el bucle de solicitudes.
Los límites de velocidad funcionan por proyecto
Google mide el uso en solicitudes por minuto, tokens por minuto y solicitudes por día. Los modelos que generan imágenes también cuentan las imágenes por minuto (IPM), una unidad que funciona como los tokens por minuto. Los límites se aplican al proyecto, no al token, así que un segundo token dentro del mismo proyecto no añade capacidad.
La página de límites de velocidad de Google no publica cifras fijas para los modelos de imagen. Remite a AI Studio, donde se listan tus límites activos para cada proyecto. Consúltalos allí en lugar de fiarte de una tabla de un blog, incluida esta.
💡 Consejo: Los reintentos se cobran como cualquier otra llamada. Añade retroceso exponencial a tu código para que una ráfaga de respuestas 429 no se convierta en una ráfaga de cargos.
Los precios proceden de la página de precios de Google en octubre de 2026.
Tres ejemplos de presupuesto
Un blog con 30 imágenes destacadas al mes con Nano Banana 2 en 1K: 30 x $0.067 = $2.01.
Un catálogo de productos de 2000 imágenes con Nano Banana 2 Lite: 2000 x $0.0336 = $67.20.
Una diseñadora que itera 40 veces al día durante 22 días laborables con Nano Banana Pro en 2K: 880 x $0.134 = $117.92.
El tercer caso es donde las facturas sorprenden a la gente. Cada regeneración es una imagen facturada, así que un prompt impreciso cuesta más que uno cuidado. Dibuja en 0.5K o con el modelo Lite, y luego renderiza el ganador una sola vez en Pro.
💡 Consejo: Crea una alerta de presupuesto en Google Cloud Billing antes de tu primera llamada de pago. Tarda dos minutos y te avisa antes de que un bucle descontrolado cause daños.
Formas gratuitas de probar Nano Banana
La aplicación de Gemini
La aplicación de Gemini de Google incluye la generación de imágenes con Nano Banana entre sus funciones, en los distintos planes de suscripción. La página de soporte de Google no publica un número diario fijo para las cuentas gratuitas, así que el límite que veas dentro de la aplicación es el que cuenta, y puede cambiar sin previo aviso. La aplicación funciona solo de forma manual. No tiene API, así que no puede alimentar un script ni un flujo de contenido.
Si primero quieres ayuda para escribir los prompts, los modelos de chat como Gemini 3.5 Flash los redactan y los afinan en el mismo lugar.
Una prueba justa de cualquier vía usa tres prompts. Primero, pide una escena con una palabra corta de texto, para ver cómo maneja el modelo las letras. Segundo, sube una sola foto de referencia y pide que aparezca la misma persona en un lugar nuevo, para comprobar la coherencia de personajes. Tercero, edita tu propio resultado con una frase sencilla como "mueve la lámpara a la estantería de la izquierda". Un modelo que supera las tres pruebas está listo para proyectos reales.
Vía
Necesita un token
Necesita facturación de Google
Funciona en scripts
API de Gemini
Sí
Sí
Sí
Aplicación de Gemini
No
No
No
Picasso IA en el navegador
No
No
No
Cómo usar Nano Banana 2 en Picasso IA
La vía del navegador necesita unos clics y ninguna configuración. Estos pasos usan el esquema publicado en la página del modelo.
Escribe una descripción en el campo Prompt. Nombra el sujeto, la luz y el objetivo, por ejemplo "luz de ventana por la mañana, 50 mm, profundidad de campo poco profunda".
Elige una relación de aspecto. La predeterminada es match_input_image, y los ajustes preestablecidos van desde 1:1 y 16:9 hasta 21:9, 9:16 y formatos altos como 1:4.
Elige una resolución de 1K, 2K o 4K. Las resoluciones más altas tardan más.
Selecciona jpg o png y ejecuta la generación.
Escribe una instrucción de seguimiento, como "oscurece el fondo", para editar el resultado en lugar de reescribir el prompt.
Ajustes que importan
Ajuste
Opciones
Consejo
image_input
Hasta 14 imágenes
Reutiliza una referencia para mantener la coherencia de un personaje entre escenas
resolution
1K, 2K, 4K
Dibuja en 1K, termina en 4K
output_format
jpg, png
Elige png para gráficos con bordes definidos
google_search
Activado o desactivado
Actívalo cuando la imagen dependa de la actualidad
image_search
Activado o desactivado
Añade imágenes web como contexto visual
Nano Banana Pro usa un formulario similar, con una resolución predeterminada de 2K y un ajuste del filtro de seguridad que va de estricto a permisivo. Elígelo cuando el trabajo sea un entregable final.
💡 Consejo: Genera tres variaciones en 1K antes de dedicar tiempo a un render en 4K. La mayoría de los prompts malos se notan en la primera miniatura.
Crea tus primeras imágenes hoy
Ya conoces el panorama real: el token es gratis, las llamadas a la API no lo son, y la vía del navegador evita ambos problemas. Si tu objetivo es ver lo que puede hacer Nano Banana, no necesitas una cuenta de facturación para empezar. Abre Picasso IA, elige Nano Banana 2 o Nano Banana Pro y escribe el primer prompt que se te ocurra.
Prueba una foto de producto, un retrato con fotos de referencia o una escena basada en la actualidad. Luego compara los resultados entre modelos en la lista completa de modelos. Experimenta con los ajustes de la tabla de arriba, guarda los prompts que te gusten y crea una pequeña biblioteca de lo que funciona. Cuando estés listo para automatizar, ya sabrás qué modelo y resolución merecen tu presupuesto de API. Antes, vuelve a la tabla de precios de este artículo y calcula tus propias cifras con el volumen que esperas. Una estimación mensual aproximada tarda un minuto y evita una sorpresa desagradable en la primera factura.