Corrección (8 de octubre de 2026): Google aplazó el cierre de
gemini-2.5-flash-image, previsto para el 2 de octubre de 2026, al 15 de marzo de 2027 como fecha más temprana, y ahora indicagemini-3.1-flash-lite-image(Nano Banana 2 Lite) como sustituto.
Sí, la API de Gemini sigue teniendo un nivel gratuito a 10 de octubre de 2026. Desde España puedes crear un proyecto y una clave de API en Google AI Studio y llamar sin facturación a los modelos de texto de la gama Flash y Flash-Lite; para un proyecto nuevo, los dos identificadores con los que empezar son gemini-3.8-flash y gemini-3.5-flash-lite. El Pro actual (gemini-3.1-pro-preview) y todos los modelos de imagen, vídeo y música solo funcionan por API con facturación.
Ese camino sirve para aprender y validar una idea, pero tiene un límite jurídico especialmente importante en Europa: las condiciones adicionales de Gemini API indican que, si ofreces un cliente API a usuarios del Espacio Económico Europeo, Suiza o Reino Unido, debes utilizar servicios de pago. Una prueba individual y una aplicación pública no tienen, por tanto, la misma respuesta.
¿Ya activaste la facturación, AI Studio muestra Tier 1 y los errores siguen citando la cuota gratuita? Ve directamente a qué revisar cuando la facturación está activada y sigues en el nivel gratuito; justo después se explica cómo volver al nivel gratuito si lo que quieres es lo contrario.
Qué modelos de Gemini son gratis por API a 10 de octubre de 2026
La página oficial de precios separa el nivel gratuito y el de pago para cada modelo. Estos son los modelos de texto cuya entrada y salida figuran como gratuitas («Free of charge») en esa fecha, con el estado que les da la lista de modelos de Google:
| Identificador | Estado | Qué tener en cuenta |
|---|---|---|
gemini-3.8-flash | Estable | El Flash más reciente; uno de los dos que Google indica para proyectos nuevos |
gemini-3.6-flash | Estable | Sigue disponible con fila gratuita |
gemini-3.5-flash-lite | Estable | El otro modelo indicado para proyectos nuevos |
gemini-3.1-flash-lite | Estable | Flash-Lite anterior |
gemini-3-flash-preview | Preview | Heredado y en versión preliminar: límites más estrictos y retirada con poco aviso |
gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite | Acceso limitado | Fila gratuita, pero solo para quien ya usaba la generación 2.5 |
gemini-3.7-flash y gemini-3.5-flash ya no aparecen en las páginas de precios ni de modelos. Según la página de obsolescencias, las peticiones a esos identificadores se redirigen automáticamente a gemini-3.8-flash y gemini-3.6-flash, respectivamente, sin fecha de cierre anunciada; si tu código aún los usa, cambia al identificador de destino para saber qué modelo te responde.
Por la API no hay nivel gratuito («Not available») para estas familias:
- el Pro actual:
gemini-3.1-pro-previewygemini-3.1-pro-preview-customtools; - imagen:
gemini-nano-banana-2.1(Nano Banana 2.1, publicado el 6 de octubre de 2026),gemini-3.1-flash-image(Nano Banana 2),gemini-3.1-flash-lite-image(Nano Banana 2 Lite),gemini-3-pro-image(Nano Banana Pro) ygemini-2.5-flash-image; - vídeo:
gemini-omni-1.1-flash,gemini-omni-flash-previewy Veo 3.1; - música: Lyria 3.5 y Lyria 3;
- voz con Pro:
gemini-2.5-pro-preview-tts.
Fuera del texto, también tienen fila gratuita los modelos Live (gemini-3.8-live), la transcripción (gemini-3.5-transcribe), la síntesis de voz (gemini-3.8-flash-tts, gemini-3.8-flash-lite-tts), Gemini Embedding 2 y Gemma 4. En cuanto a herramientas, el nivel gratuito incluye 500 solicitudes al día de fundamentación con la Búsqueda de Google, compartidas entre Flash y Flash-Lite, además de ejecución de código, contexto de URL y búsqueda en archivos; el uso del ordenador (Computer use) queda fuera.

Los nombres, los estados y los precios cambian con cada lanzamiento. Abre la fila del identificador exacto que va a usar tu código el día de la integración, no la del nombre comercial de la familia.
Cuándo una fila gratuita no significa que puedas usar el modelo
Una fila con coste cero indica que el uso elegible no se cobra por token. No garantiza que tu proyecto tenga acceso ni un volumen concreto. Hay tres casos en los que la tabla engaña:
Generación 2.5 en un proyecto nuevo. Google limita el acceso a los modelos 2.5 a quienes los han usado activamente antes y remite los proyectos nuevos a 3.5 Flash-Lite o 3.8 Flash. Los modelos no están retirados, pero «Gemini 2.5 Pro gratis» no es un plan fiable si acabas de crear el proyecto. Google no precisa qué cuenta como uso activo.
Modelos Preview. Según la lista de modelos, las versiones preliminares suelen exigir facturación, pueden tener límites más restrictivos y se retiran con un aviso mínimo de dos semanas. Por eso gemini-3-flash-preview no es una buena base aunque su fila sea gratuita, y «Gemini 3 Flash» no debe confundirse con la gama Flash actual.
«Can be tested in Google AI Studio». Esa nota acompaña a Gemini 3.1 Pro Preview, Nano Banana 2 y Nano Banana Pro. Se refiere a probarlos en la interfaz web de AI Studio; por API siguen sin nivel gratuito.
Dos comprobaciones más evitan errores con identificadores heredados. gemini-2.0-flash, gemini-2.0-flash-lite, gemini-3.1-flash-lite-preview y gemini-3-pro-preview están apagados, y gemini-2.5-flash-image está obsoleto: Google fija el 15 de marzo de 2027 como fecha más temprana de cierre y propone gemini-3.1-flash-lite-image como sustituto. El alias gemini-flash-latest funciona, pero Google lo redirige al modelo nuevo en cada lanzamiento: es cómodo para experimentar y poco adecuado si necesitas un comportamiento fijo.
Con qué modelo empezar: gemini-3.8-flash o gemini-3.5-flash-lite
Para un proyecto nuevo, empieza con gemini-3.8-flash: es estable, tiene fila gratuita y Google lo presenta como su Flash más inteligente. Elige gemini-3.5-flash-lite si tu tarea es sencilla y repetitiva y prefieres la variante ligera de la gama. Ambos son los que Google recomienda cuando no tienes historial con la generación 2.5.
Fija en el código el identificador estable en lugar del alias, y revisa la lista cuando aparezca un modelo nuevo. Los detalles del modelo están en Gemini 3.8 Flash API: ID, precios, límites y migración; si dudas entre gamas, Modelos de texto Gemini en 2026: Flash, Flash-Lite o Pro compara cuál encaja con cada tarea.
La app gratuita de Gemini no es el nivel gratuito de la API
«Modelos de Gemini gratis» puede referirse a dos productos distintos. La app de Gemini es un producto para consumidores con su propio plan gratuito; la API se usa con una clave y un proyecto, y sus modelos gratuitos son los de la tabla anterior.
A 1 de octubre de 2026, la página de planes de Google describe el plan gratuito de la app con 3.6 Flash, avisa de que el acceso a 3.1 Pro puede cambiar e incluye generación y edición de imágenes, Deep Research, Gemini Live, Canvas y Gems. El uso se mide por cómputo —complejidad de la petición, funciones usadas y longitud de la conversación— y se repone cada cinco horas hasta un límite semanal. El contenido de los planes varía según el país, así que confirma el tuyo en esa página.
Una suscripción de Gemini no concede cuota de Gemini Developer API, y poder probar un modelo en la app o en la interfaz de AI Studio no demuestra que tenga acceso gratuito por API.
En España, decide primero si es prueba o servicio
España figura en la lista de regiones disponibles, y las preguntas frecuentes de facturación de Google responden que sí se puede usar Gemini API gratis en el EEE, Reino Unido y Suiza. Eso confirma el acceso regional, pero no convierte el nivel gratuito en la ruta adecuada para cualquier producto.
Una prueba personal con datos no sensibles puede permanecer en un proyecto sin facturación. En cambio, una aplicación que se ofrece a usuarios del EEE entra en la condición de servicio de pago de las condiciones actuales. Esta distinción debe resolverse antes de calcular cuántas peticiones caben en la cuota.
Si lo que falla es el acceso mismo, Gemini no está disponible en tu país: cómo saber qué requisito falla separa las causas posibles.
La cifra correcta es la de tu proyecto
Google no publica una tabla de límites gratuitos por modelo. Su documentación de límites de frecuencia explica tres medidas y remite a AI Studio para ver los valores activos de cada proyecto:
| Medida | Qué cuenta | Señal habitual |
|---|---|---|
| RPM | peticiones por minuto | un pico de concurrencia falla enseguida |
| TPM | tokens de entrada por minuto | documentos grandes agotan el límite con pocas llamadas |
| RPD | peticiones por día | el proyecto deja de responder tras gastar el cupo diario |
RPD se reinicia a medianoche del horario del Pacífico, no a medianoche en España. Los límites se aplican por proyecto, no por clave. Varias claves del mismo proyecto comparten el mismo fondo. Un notebook, un trabajo programado y un backend de pruebas pueden consumirlo sin que el equipo lo vea como una sola carga.
Los modelos preview y experimentales pueden tener límites más estrictos. Además, Google señala que los límites indicados no garantizan la capacidad real. Por eso un RPM o un RPD fijo tomado de una lista que no es la de tu proyecto no es una base suficiente para diseñar el servicio.
Antes de estimar capacidad:
- identifica el proyecto al que pertenece la clave;
- abre sus límites activos en AI Studio;
- selecciona el ID exacto del modelo;
- anota RPM, TPM, RPD y el nivel del proyecto;
- suma todas las cargas que comparten ese proyecto.
Si cada solicitud contiene un documento largo, TPM puede ser el cuello de botella aunque sobren peticiones. Si el texto es corto y llegan muchos usuarios a la vez, el primer problema suele ser RPM. Cómo cambian esos valores al subir de nivel se explica en Límites de Gemini API por nivel: valores activos y diagnóstico del error 429.
Primera llamada con la API actual
La guía de inicio vigente parte de la Interactions API mediante google-genai. AI Studio crea automáticamente un proyecto y una clave de API para los usuarios nuevos; guárdala como variable de entorno:
export GEMINI_API_KEY="YOUR_API_KEY"
pip install -U google-genaiDespués realiza una llamada mínima con un modelo estable que tenga fila gratuita:
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.8-flash",
input="Explica una base de datos vectorial en tres frases.",
)
print(interaction.output_text)Al recibir la respuesta, vuelve al panel de uso. Comprueba que la petición se registró en el proyecto esperado y bajo ese modelo. Así detectas una variable de entorno incorrecta, una clave de otro proyecto o un ID obsoleto. No pongas una clave sin protección en el frontend ni la subas a Git.
Un 429 no siempre se arregla esperando
429 RESOURCE_EXHAUSTED puede corresponder a cualquiera de las dimensiones de cuota.
- Si ocurre tras una ráfaga, reduce concurrencia y aplica reintentos exponenciales con variación aleatoria.
- Si ocurre con pocas peticiones grandes, reduce o divide la entrada para aliviar TPM.
- Si todo funcionó durante horas y después dejó de hacerlo, comprueba RPD.
- Si fallan varias claves al mismo tiempo, revisa el proyecto compartido.
- Si el problema afecta a un preview, compara con un modelo estable que cumpla la misma tarea.
- Si tu proyecto ya tiene facturación y el error sigue nombrando una cuota
free_tier, el ritmo no es el problema: sigue la comprobación de facturación.
El reintento ayuda con una ventana breve; no repone un cupo diario. Ten en cuenta además que las solicitudes fallidas con error 400 o 500 no se cobran por tokens, pero sí cuentan para la cuota, de modo que un bucle de reintentos mal acotado la gasta. El diagnóstico de errores 429, 400 y 500 de Gemini API cubre los siguientes pasos cuando el código no revela la causa.
En España, el uso de datos tiene una excepción regional
Como regla general, en los servicios no pagados Google usa el contenido enviado y las respuestas para mejorar sus productos, revisores humanos pueden leerlo y las condiciones piden no enviar información sensible, confidencial o personal.
Las mismas condiciones establecen una excepción: en el EEE, Suiza y Reino Unido, las reglas de uso de datos de los servicios de pago se aplican a todos los servicios, incluidos Google AI Studio y la cuota no pagada de Gemini API. Aunque el acceso tenga precio cero, Google indica bajo esas reglas que no utiliza los prompts ni las respuestas para mejorar sus productos.
Esta excepción regional no elimina la necesidad de revisar seguridad, conservación y cumplimiento, ni convierte cualquier dato en apropiado para una prueba. Usa datos sintéticos o no sensibles cuando sea posible. Además, es una cuestión distinta de la regla de distribución: si ofreces un cliente API a usuarios del EEE, las mismas condiciones exigen utilizar servicios de pago.
Facturación: prepago mínimo de 5 USD y un crédito que no debes contar
La guía oficial de facturación explica que el paso a pago requiere asociar una cuenta de facturación y, en el plan de prepago, comprar al menos 5 USD de crédito o su equivalente en moneda local; la interfaz muestra el mínimo que corresponde a tu región. El cambio del nivel gratuito al nivel 1 suele aplicarse al instante. Las claves heredan el estado del proyecto; no tienen un interruptor de facturación independiente.
Conviene conocer tres detalles del prepago antes de activarlo:
- el crédito no usado caduca a los 12 meses;
- con saldo 0, las solicitudes fallan con HTTP 402 y el proyecto no vuelve por sí solo al nivel gratuito;
- para regresar al nivel gratuito hay que desvincular el proyecto de la cuenta de facturación (qué cambia al hacerlo).
No confundas ese saldo con el crédito promocional de 300 USD para nuevos usuarios de Google Cloud. Google indica que, para cuentas de facturación abiertas después del 2 de marzo de 2026, ese crédito de bienvenida no puede pagar Gemini API ni AI Studio.
Activa la facturación antes de ofrecer el cliente API a usuarios del EEE y también cuando la fiabilidad, un modelo de pago o el trabajo operativo alrededor de la cuota pesen más que el coste previsto. En Gemini API, el acceso se considera servicio de pago cuando la solicitud pasa por un proyecto con una cuenta de facturación activa. Después, sigue vigilando límites, saldo y topes de gasto: pagar aumenta la ruta disponible, pero no elimina todos los controles.
Los pasos para contratar con una cuenta propia están en Cómo pagar Gemini API sin comprar una clave revendida. Si necesitas comparar el coste por modelo, continúa con la guía de precios por token de Gemini API, cuyas tarifas corresponden a marzo de 2026.
Facturación activada y sigues en el nivel gratuito: qué revisar
Si ya vinculaste una cuenta de facturación, AI Studio muestra Tier 1 y aun así la API aplica la cuota del nivel gratuito, lo más probable es una de dos cosas: la petición sale de una clave de otro proyecto, o la cuenta de facturación no está en un estado que Google acepte para el nivel de pago. El tiempo de espera solo explica el problema en los primeros minutos tras pagar con tarjeta, o durante varios días si pagaste por transferencia. Revisa en este orden: clave y proyecto, cuenta de facturación, tiempo transcurrido y tipo de cuenta.
Antes de cambiar nada, lee el cuerpo completo del error. Tres fallos distintos se parecen mucho:
| Lo que devuelve la API | Qué significa | Qué hacer |
|---|---|---|
429 con la métrica generate_content_free_tier_requests o un quota ID terminado en -FreeTier | La petición se evaluó contra la cuota gratuita | Sigue los pasos de esta sección |
429 con free_tier y limit: 0 en un modelo de imagen o en el Pro actual | Lo mismo; esos modelos tienen cuota gratuita cero y fallan desde la primera llamada | Sigue los pasos de esta sección |
| 402 Payment Required | El saldo de prepago llegó a 0; el proyecto no baja solo al nivel gratuito | Compra crédito en la página Billing de AI Studio |
429 cuya métrica no menciona free_tier | Has alcanzado un límite del nivel de pago (RPM, TPM, RPD o el gasto por ventana de 10 minutos, 10 USD en Tier 1) | Reduce el ritmo y consulta los límites por nivel |
Que el texto funcione y la imagen falle no demuestra que la clave sea la correcta. Los modelos de texto con fila gratuita responden dentro de la cuota gratuita y solo fallan al agotarla; los modelos sin nivel gratuito fallan al instante con limit: 0. Así lo explicó el personal de Google en el foro Google AI Developers el 29 de julio de 2026, ante un proyecto Tier 1 al que se le rechazaba gemini-3.1-flash-image.

1. ¿La clave que usa tu código pertenece al proyecto con facturación?
Google fija el nivel en la cuenta de facturación; los proyectos vinculados lo heredan y las claves heredan el del proyecto, sin ajustes de facturación propios (guía de facturación). «Mi cuenta tiene Tier 1» y «mi petición usa Tier 1» no son lo mismo. AI Studio crea un proyecto y una clave por defecto a los usuarios nuevos, así que es fácil tener un proyecto con facturación y otro sin ella en la misma cuenta, o una clave creada en la consola de Google Cloud dentro de un tercer proyecto.
Dónde mirar: en la página API keys de AI Studio cada clave aparece junto a su proyecto, y en la página Projects la columna Billing Tier muestra el nivel y el plan de facturación de cada uno. Localiza la clave que carga tu código donde se ejecuta de verdad (la variable de entorno del servidor, no la de tu portátil) y comprueba en qué proyecto está. Si el proyecto no aparece en AI Studio, impórtalo desde Projects con Import projects.
El personal de Google en el foro Google AI Developers suele empezar por aquí. El 11 de agosto de 2026 citó como una de las causas que el proyecto con el que se creó la clave no estuviera vinculado a la cuenta de facturación, aunque la cuenta estuviera activa. En otro hilo (7 de julio de 2026), Google no encontró ningún 429 en el proyecto que el usuario decía usar y supuso una confusión entre proyectos y claves. Y el 21 de agosto de 2026 la solución propuesta fue crear una clave nueva directamente en el proyecto Tier 1 y usar esa.
Pasas al siguiente punto cuando la clave de tu código está en el proyecto que muestra Tier 1 y esa fila no indica «Set up billing», «Set up Prepay» ni «No credits».
2. ¿La cuenta de facturación está activa y sin pagos pendientes?
Si el proyecto es el correcto, el siguiente sospechoso es la cuenta de facturación. Casi todo esto se corrige en la consola de Google Cloud, no en AI Studio.
- Avisos en Projects. «Set up billing» significa que el proyecto no tiene cuenta de facturación; «Set up Prepay», que la tiene pero debe configurar el prepago; «No credits», que el prepago no está configurado o el saldo se ha agotado. Con prepago, la API solo atiende peticiones mientras el saldo sea positivo.
- Prueba gratuita de Google Cloud (Free trial). No es el nivel gratuito de Gemini API, sino el periodo de prueba de la cuenta de facturación de Cloud. Una cuenta en ese estado no es apta para el nivel de pago, y AI Studio puede mostrar «The billing account type is inactive or unsupported». El 8 de septiembre de 2026, el personal de Google respondió a un caso con saldo prepago que el proyecto estaba limitado al nivel gratuito precisamente por eso: hay que completar la actualización en la página de facturación de la consola de Cloud y después añadir crédito de prepago en AI Studio. En esa misma respuesta aclaró que no existe un mecanismo manual de sincronización.
- Cuenta cerrada. Da el mismo mensaje; la solución es reabrirla.
- Pagos pendientes. Un saldo moroso, un pago rechazado o un método de pago caducado suspenden Gemini API aunque tengas crédito de prepago, también cuando la deuda es de otro servicio de Cloud en pospago.
- Prepago a medias. Si empezaste a añadir prepago a una cuenta de pospago y cancelaste después de confirmar el cambio, la cuenta queda en un estado en el que no se le puede cobrar, y eso afecta a todos sus proyectos. Termina la configuración o pide al soporte de facturación de Cloud que la restablezca.
- Créditos de Cloud. Los 300 USD de bienvenida no pagan Gemini API en cuentas abiertas después del 2 de marzo de 2026, y con prepago ningún crédito de Cloud se aplica hasta que compras crédito de prepago. Un informe en GitHub de marzo de 2026 describe el caso: proyecto creado en la consola de Cloud, cuenta con créditos vinculada, API habilitada y clave creada allí; la cuota seguía siendo la gratuita y Google no respondió. Es una inferencia, pero la explicación más coherente con la documentación es que vincular la facturación solo en la consola, sin completar el pago en AI Studio, no basta.
- Pospago con poco historial. El 29 de julio de 2026, el personal de Google atribuyó un caso de Tier 1 en pospago a la poca actividad de facturación histórica de la cuenta y ofreció dos salidas: hacer un prepago o un pago anticipado, o vincular otra cuenta activa con historial de pagos. El 12 de agosto, a alguien que había pagado por adelantado en una cuenta de pospago le respondió que la cuenta debe alcanzar el umbral de subida al margen de lo prepagado. Ninguna de las dos condiciones figura en la documentación.
Pasas al siguiente punto cuando la consola de Cloud muestra la cuenta activa (ni en prueba gratuita ni cerrada) y sin pagos pendientes, y la página Billing de AI Studio muestra tu plan con saldo positivo si es de prepago.
3. ¿Cuánto tarda en aplicarse el nuevo nivel?
Según la documentación de límites, el paso del nivel gratuito a Tier 1 suele ser inmediato, y la guía de facturación añade que, tras un pago correcto, el nuevo nivel se refleja normalmente en menos de 10 minutos. Las transferencias bancarias pueden tardar varios días, y el servicio no sube de nivel hasta que la compra de crédito queda confirmada. Los gráficos de coste pueden tardar hasta 24 horas en actualizarse, así que no los uses para saber si el pago ha llegado.
Si pagaste con tarjeta hace más de 10 minutos y los dos puntos anteriores están bien, el tiempo ya no explica el fallo. La misma página advierte de que, en casos raros, Google puede denegar una subida de nivel por otros factores, sin detallar cuáles.
4. ¿Es un proyecto de Google Workspace?
Se ha informado de que los proyectos de cuentas de Google Workspace (cuentas de empresa o de centro educativo) no reciben nivel gratuito, pero la documentación de Google no lo dice. Su página sobre Workspace solo indica que AI Studio está activado por defecto en todas las ediciones, que el administrador puede desactivarlo por unidad organizativa y que en Workspace for Education los menores de 18 años no pueden usarlo.
Los indicios vienen de usuarios. Una prueba publicada en note.com en febrero de 2026 encontró que, en una cuenta de Workspace, los proyectos sin facturación mostraban «Unavailable» como nivel de cuota y la primera petición devolvía 429, mientras que los mismos pasos funcionaban con una cuenta personal de Gmail. En septiembre de 2026, varios hilos del foro describen proyectos de Workspace, uno de ellos de Education, con «Billing Tier: Unavailable», estado «Restricted» y el error 403 «Your project has been denied access». Hay un matiz importante: el personal de Google atribuye «Unavailable» a marcas automáticas en la cuenta, y ese estado también apareció en una cuenta personal de Gmail.
Para comprobarlo, haz la misma llamada con el mismo modelo desde un proyecto de una cuenta personal. Si allí funciona y en Workspace no, el tipo de cuenta es la diferencia más probable. Para las marcas en la cuenta, el personal de Google pide completar la verificación de edad, la verificación del teléfono y la verificación en dos pasos, y como alternativa configurar la facturación, advirtiendo de que así se pierde la cuota gratuita.
5. Si todo está bien: avisos de AI Studio y soporte de facturación
No todos los casos los causa el usuario. El 2 de septiembre de 2026, el personal de Google reconoció que un proyecto Tier 1 que llevaba 48 horas recibiendo 429 en todas las llamadas sufría «un error temporal del backend», ya corregido. En abril de 2026, otro usuario contó que su error free_tier con limit: 0 en un modelo de imagen desapareció al día siguiente sin cambiar nada.
Google no publica ninguna forma de resincronizar el nivel ni la lista de condiciones que pueden mantener un proyecto Tier 1 con cuota gratuita. Lo que sí puedes hacer:
- busca avisos o errores en las páginas Projects y Billing de AI Studio; según el personal de Google (20 de julio de 2026), las marcas automáticas suelen mostrar ahí los siguientes pasos o un enlace de apelación;
- abre un caso con el soporte de facturación de Google Cloud; si no eres administrador de la cuenta de facturación, esa página te remite a otras vías de contacto;
- si no puedes abrir el caso, publica en el foro Google AI Developers el número de proyecto, el ID de la cuenta de facturación, el modelo, la hora y el cuerpo completo del 429, nunca la clave de API;
- mientras tanto, solicita un aumento temporal del límite, como sugiere el personal de Google, y no repitas en bucle peticiones que fallan con
limit: 0.
Volver al nivel gratuito: desvincula la facturación del proyecto
Para volver al nivel gratuito, desactiva la facturación en cada proyecto que quieras bajar, es decir, desvincúlalo de su cuenta de facturación en la consola de Google Cloud (guía de facturación). Quedarte sin saldo no lo hace por ti: con el prepago a 0 las peticiones fallan con 402 hasta que compras crédito o desvinculas el proyecto.
Antes de hacerlo, ten en cuenta qué cambia:
- Solo baja el proyecto que desvinculas. El nivel pertenece a la cuenta de facturación, y los demás proyectos vinculados a ella siguen en el nivel de pago.
- El saldo de prepago se queda en la cuenta de facturación. No pasa al proyecto ni, en general, se reembolsa; Google solo devuelve el crédito al cambiar de prepago a pospago. Caduca a los 12 meses de la compra y se pierde si cierras la cuenta de facturación, así que no la cierres si piensas volver.
- Vuelven los límites gratuitos. El Pro actual y los modelos de imagen vuelven a fallar con
limit: 0. - No hace falta desvincular para probar gratis. AI Studio permite alternar entre proyectos de pago y gratuitos usando la clave de cada uno. Un proyecto con facturación para producción y otro sin ella para pruebas evita deshacer y rehacer la configuración de pago.
- Datos. Mientras al menos un proyecto tenga facturación, Google trata tus prompts de AI Studio con las condiciones de los servicios de pago; se deduce que, cuando ya ninguno la tiene, se aplican las de los servicios no pagados. En el EEE, Suiza y Reino Unido las condiciones actuales ya aplican las reglas de datos de pago a todos los servicios, como se explica más arriba.
- Apps para el EEE. Si ofreces el cliente API a usuarios del EEE, Suiza o Reino Unido, un proyecto sin facturación deja de cumplir la condición de servicio de pago.
- Workspace. Si lo que se ha informado sobre Workspace se cumple en tu cuenta, un proyecto de Workspace desvinculado puede quedarse con el nivel «Unavailable» en lugar de volver a una cuota gratuita utilizable.
Preguntas rápidas sobre Gemini API gratis
¿La API de Gemini es gratis?
Sí, en parte. Crear la clave de API en Google AI Studio no cuesta nada y los modelos Flash y Flash-Lite de la tabla tienen entrada y salida gratuitas dentro de los límites de tu proyecto. El Pro actual, la imagen, el vídeo y la música por API requieren facturación.
¿Gemini 2.5 Pro es gratis por API?
gemini-2.5-pro conserva una fila gratuita en la página de precios, pero Google limita la generación 2.5 a quienes ya la usaban. En un proyecto nuevo no cuentes con él; el Pro actual, gemini-3.1-pro-preview, no tiene nivel gratuito.
¿Cuántas imágenes gratis me da Gemini?
Por la API, ninguna: todos los modelos de imagen figuran como no disponibles en el nivel gratuito. La app de Gemini sí incluye generación y edición de imágenes en su plan gratuito, sin una cifra diaria publicada en la página de planes, porque el uso se mide por cómputo. Las vías de acceso se comparan en Gemini Image Generation Free Tier: app, AI Studio o API.
¿Cómo puedo ver la facturación de Gemini API y en qué nivel estoy?
En AI Studio. La página Projects muestra en la columna Billing Tier el nivel y el plan de cada proyecto, junto con avisos como «Set up billing», «Set up Prepay» o «No credits»; la página Billing muestra el plan, el saldo de prepago y los pagos, y Dashboard > Usage, el consumo. Los costes también aparecen en la consola de Google Cloud, normalmente con hasta un día de retraso, pero el saldo de prepago solo se gestiona en AI Studio.
¿Por qué mi proyecto de Gemini API sigue en el nivel gratuito si ya pagué?
Las causas que documenta o ha confirmado Google son que la clave que usa tu código sea de otro proyecto, que la cuenta de facturación siga en prueba gratuita de Cloud, tenga pagos pendientes o un prepago sin terminar, o que aún no hayan pasado unos 10 minutos desde el pago con tarjeta. Si todo eso está bien, puede tratarse de una marca en la cuenta o de un fallo de Google; el orden completo está en qué revisar cuando sigues en el nivel gratuito.
Prueba gratis, app para el EEE de pago: la regla para no equivocarse
Para aprender o demostrar una idea en España, el nivel gratuito sigue siendo una opción válida: verifica el identificador en la página de precios, lee la cuota activa del proyecto y envía una llamada mínima con gemini-3.8-flash. Para una aplicación dirigida a usuarios del EEE, planifica desde el principio un servicio de pago y una revisión adecuada de datos.
Esta separación evita dos errores opuestos: pagar antes de saber si la idea funciona y construir un producto real sobre una cuota gratuita que no cumple las condiciones del propio producto.



