Respuesta directa, comprobada el 22 de julio de 2026: España figura en la lista oficial de regiones admitidas para Gemini API y Google AI Studio. Eso permite usar la ruta oficial, pero no garantiza un método de pago, una divisa, el IVA, una política de organización o un plan concreto. Esos datos pertenecen a la cuenta que ve el usuario al iniciar sesión.
Para saber cómo se factura un proyecto, no mires la API key de forma aislada. La cadena correcta es clave → proyecto → cuenta de Cloud Billing. El proyecto hereda de esa cuenta el plan Prepay o Postpay, el usage tier y el tope agregado. Por eso dos claves del mismo proyecto no consiguen dos cuotas, y mover un proyecto a otra cuenta puede cambiar más que el pagador.
“Decisión rápida: si no puedes identificar el project ID y la cuenta vinculada, no compres créditos. Si puedes identificarlos, lee el plan que muestra AI Studio; no supongas que Tier 3 significa Postpay ni que una cuenta de Cloud con cobro posterior convierte automáticamente Gemini en pospago.
La tarjeta de facturación que puedes completar en 60 segundos
Abre AI Studio y Cloud Billing con el mismo usuario autorizado. Copia estos campos antes de cambiar un límite o añadir saldo:
| Campo | Superficie de comprobación | Resultado que necesitas |
|---|---|---|
| Proyecto pagado | AI Studio → Projects | Project ID exacto al que pertenece la clave |
| Cuenta vinculada | AI Studio → Billing / Projects | ID y estado activo de la cuenta de Cloud Billing |
| Nivel de uso | Billing o Rate Limits | Free, Tier 1, Tier 2 o Tier 3 mostrado ahora |
| Plan de Gemini API | Billing | Prepay o Postpay, tal como aparece en la cuenta |
| Estado de cobro | Billing / Payment Overview | Saldo y recarga si es Prepay; método y ciclo si es Postpay |
| Controles activos | Spend / Rate Limits | Tope del proyecto, cap de cuenta, budget alerts y límites de tasa por separado |
Guarda la tarjeta junto al runbook de producción. Cuando se corte el servicio, permitirá distinguir un saldo agotado de un 429, un pago rechazado o un tope mensual sin depender de recuerdos sobre cuándo se creó la cuenta.
Una cuenta, dos ejes: plan de pago y nivel de uso
El plan de pago describe el momento del cobro:
- Prepay: compras créditos antes de consumir Gemini API y el uso reduce ese saldo.
- Postpay: Cloud Billing cobra después, al alcanzar un threshold o durante el ciclo mensual.
El nivel de uso describe la cualificación y los límites que hereda el proyecto. No es una modalidad de pago. La documentación oficial de billing de Gemini API mostraba estos requisitos al verificarla:
| Nivel | Requisito de la cuenta vinculada | Cap mensual agregado actual |
|---|---|---|
| Free | Proyecto activo o free trial | Sin gasto de pago |
| Tier 1 | Vincular una cuenta de facturación activa | $250 |
| Tier 2 | Al menos $100 pagados y 3 días desde el primer pago correcto | $2.000 |
| Tier 3 | Al menos $1.000 pagados y 30 días desde el primer pago correcto | $20.000–$100.000 |
Son valores contractuales verificados el 22 de julio de 2026, no una promesa permanente ni una conversión a euros. Para Tier 2 y Tier 3, Google considera el gasto acumulado de Google Cloud en la cuenta vinculada, no solo el coste de Gemini ni el de un proyecto. El upgrade suele ser automático al cumplir dinero y antigüedad; la pantalla puede tardar unos 10 minutos en reflejarlo y una ampliación de capacidad no está garantizada.
Los usuarios nuevos reciben Prepay por defecto, pero existen cuentas migradas y estados específicos. Tier 3 solo puede llegar a ser elegible para Postpay; no lo obtiene automáticamente. Además, el cambio manual figura temporalmente deshabilitado en la documentación actual. La fila de tu AI Studio, no la fecha de una guía, decide qué plan tienes.
Esta página no congela tarifas por modelo. Entrada, salida, caché, batch, herramientas y medios tienen precios distintos; consulta el tarifario actualizado de Gemini API cuando ya hayas identificado el plan.
Prepago: el saldo es necesario, pero no explica todos los cortes
En Prepay se compra saldo antes del primer uso de pago. Google publica actualmente una compra mínima de 10 USD o equivalente local, un máximo de 5.000 USD, 12 meses de vigencia y recarga automática opcional. El checkout de la cuenta determina la moneda, impuestos y medios disponibles en España; no conviertas esos importes públicos en una garantía de tarjeta, EUR o tratamiento fiscal.
Cuando el saldo llega a cero, se detienen todas las API keys de todos los proyectos asociados a esa cuenta de facturación. El proyecto no baja por sí solo a Free. Crear otra clave tampoco ayuda, porque hereda el mismo proyecto. La corrección es añadir créditos a la cuenta correcta o, si se quiere abandonar el uso pagado y la interfaz lo permite, desvincular billing de forma deliberada.
La recarga automática reduce cortes, pero su límite mensual solo controla compras automáticas. Una compra manual queda fuera. Tampoco existe un cierre contable instantáneo: el procesamiento puede retrasarse unos 10 minutos y dejar un pequeño saldo negativo; una tarea batch o agéntica ya iniciada puede seguir consumiendo durante ese intervalo.
Los créditos promocionales de Google Cloud exigen otra comprobación. Solo los créditos elegibles pueden aplicarse, y la cuenta necesita primero saldo prepago positivo. Al agotarse ese saldo, también se detiene el consumo del crédito elegible. Además, el crédito de bienvenida de 300 USD no cubre Gemini API/AI Studio para cuentas abiertas después del 2 de marzo de 2026. Ver un crédito en Cloud Console no demuestra que pagará este servicio.
Pospago: revisa la salud del pago
Postpay no usa una cartera de créditos Gemini. El gasto pasa al ciclo o threshold de Cloud Billing. Aun así, una tarjeta caducada, un pago rechazado, una deuda o una cuenta inactiva puede suspender la API. Un problema de pago de otros servicios de Google Cloud también puede afectar a Gemini bajo la misma cuenta.
No confundas esto con el ciclo general de Cloud. La guía oficial del ciclo de Cloud Billing distingue cuentas facturadas, autoservicio pospago y el payment account prepago específico de Gemini. Una cuenta autoservicio puede pagar otros productos de Cloud a mes vencido y mantener Gemini API en Prepay al mismo tiempo.
El project spend cap es independiente del plan
AI Studio puede ofrecer un project spend cap experimental, pero su disponibilidad es limitada y específica de la cuenta; la fuente compartida no permite restringirlo a Prepay o Postpay. Actúa sobre un proyecto, requiere permisos IAM adecuados y puede rebasarse por el retraso aproximado de 10 minutos del procesamiento. Es un control útil, no un techo contable perfecto.
Si el proyecto cambia de billing account, puede conservar el valor configurado del cap pero reiniciar su gasto acumulado para el nuevo ciclo y heredar el plan, Tier y límites de la cuenta de destino. Antes de configurarlo, comprueba que el control aparece para ese proyecto y esa cuenta en el AI Studio autenticado.
Seis controles con nombres parecidos y efectos distintos
| Control | Alcance | Efecto real | No significa |
|---|---|---|---|
| Saldo Prepay | Cuenta de pago Gemini | Financia uso hasta agotarse | Downgrade automático a Free ni metering instantáneo |
| Límite mensual de auto-reload | Compras automáticas | Limita cuánto recarga el sistema | Tope de uso; no incluye compras manuales |
| Cap mensual del billing account | Tier compartido | Agrega el gasto Gemini de proyectos vinculados y los pausa al alcanzarse | Presupuesto independiente por proyecto |
| Project spend cap | Un proyecto; disponibilidad limitada y específica de la cuenta | Intenta detener el gasto mensual del proyecto | Cero overshoot ni disponibilidad universal |
| Cloud Billing budget | Ámbito de Cloud elegido | Mide y envía alertas por umbral | Hard cap automático |
| Spend-rate limit | Proyecto, ventana móvil | Limita velocidad de gasto y puede devolver 429 | Control del gasto mensual |
La documentación oficial de Cloud Billing Budgets es explícita: el budget no limita el uso ni el gasto. Las notificaciones programáticas sirven para construir acciones, pero pueden llegar tarde o duplicadas. Desactivar billing automáticamente puede parar servicios o afectar recursos; cualquier automatización debe probar el corte y la recuperación antes de tocar producción.
El spend-rate es parte de los rate limits, no del presupuesto. Los valores públicos actuales son $10 por ventana móvil de 10 minutos en Tier 1 y $200 en Tier 2/3. Al alcanzarlo aparece 429 RESOURCE_EXHAUSTED. No demuestra que falten créditos ni que se haya agotado el cap mensual. AI Studio muestra los límites activos por proyecto y modelo; la estrategia completa para RPM, TPM, RPD y reintentos está en la guía de límites de Gemini API.
Matriz de diagnóstico de una interrupción
| Señal observada | Primera comprobación | Acción segura |
|---|---|---|
| El proyecto no aparece en Billing | Project ID, cuenta iniciada y permisos IAM | Recuperar acceso al proyecto correcto; no comprar saldo en otra cuenta |
| Prepay muestra saldo 0 | Cuenta vinculada y lista de proyectos asociados | Comprar créditos en esa cuenta o desactivar paid billing conscientemente si procede |
| Hay Cloud credits, pero Gemini no consume | Tipo, fecha y eligibility del crédito; saldo Prepay positivo | Aplicar la regla publicada del crédito; no asumir que todo crédito es compatible |
| Postpay muestra pago fallido, vencido o pendiente | Payment Overview y estado global de Cloud Billing | Resolver el pago con el owner de la cuenta |
| Saldo positivo y respuesta 429 | Active Rate Limits, tamaño/tasa de solicitudes y spend-rate | Reducir carga o seguir la guía de rate limits; no recargar a ciegas |
| Se alcanza el project spend cap | Spend del proyecto y retraso de procesamiento | Esperar al ciclo o ajustar el cap tras investigar el pico |
| Se alcanza el cap mensual del Tier | Gasto combinado de todos los proyectos vinculados | Esperar al primer día del ciclo o comprobar elegibilidad del siguiente Tier |
| Llega un budget alert y la API continúa | Umbral y ámbito del budget | Comportamiento esperado: decidir manualmente o ejecutar automatización probada |
No atribuyas todos los errores a billing. 400 FAILED_PRECONDITION puede indicar que el free tier no está disponible en la región de la solicitud. 403 PERMISSION_DENIED, 500, 503 y 504 tienen diagnósticos diferentes. Google indica además que los fallos 400/500 no se cobran por tokens, aunque sí cuentan contra cuota.
Un ejemplo de control que no promete cero excedente
Imagina una cuenta con producción y pruebas. En lugar de crear un único «presupuesto» ambiguo:
- asigna un project spend cap al entorno de pruebas si el AI Studio autenticado ofrece el control para ese proyecto;
- usa un budget con alertas tempranas para observar el total de la cuenta;
- en Prepay, configura auto-reload con un límite de compras automáticas y revisa por separado cualquier compra manual;
- registra en la aplicación project ID, modelo, tokens, reintentos y código de estado;
- aplica un umbral interno conservador antes del cap publicado y prueba qué ve el usuario durante la pausa;
- documenta quién puede corregir el pago y quién decide aumentar un cap.
El margen interno importa porque balance, Tier y gráficos no sincronizan al mismo tiempo. El saldo suele reflejarse en minutos, un cambio de Tier normalmente dentro de unos 10 minutos y el desglose de costes puede retrasarse hasta 24 horas. No dupliques una compra ni subas un límite solo porque un gráfico todavía no se actualizó.
Qué ruta tomar ahora
- Free: confirma que el modelo y el volumen necesarios siguen disponibles; las condiciones están en la guía del nivel gratuito de Gemini API.
- Paid + Prepay: comprueba saldo, recarga y eligibility de créditos antes de investigar Tier o cuota.
- Paid + Postpay: comprueba payment health y el cap compartido de la cuenta.
- Project spend cap visible en tu cuenta: revísalo por separado a nivel de proyecto, sea cual sea el plan asignado.
- Cuenta sana + 429: abre Rate Limits y diagnostica tasa/tamaño de la carga; no cambies el plan de pago por reflejo.
La cuenta iniciada es la fuente de verdad para el plan asignado, la moneda, los impuestos, el método de pago, los límites activos y la disponibilidad del project cap. Las cifras públicas de esta guía quedaron verificadas el 22 de julio de 2026 y deben volver a revisarse antes de cualquier cambio operativo importante.
