Cuota de la API de Gemini superada (429 RESOURCE_EXHAUSTED)
La API de Gemini devuelve 429 RESOURCE_EXHAUSTED cuando supera un límite de velocidad o una cuota diaria. En el nivel gratuito, los límites son pequeños. Esta página explica cada forma del error, los límites gratuitos actuales y las soluciones que funcionan.
El código, los nombres de los modelos y las etiquetas del catálogo en vivo se muestran en inglés.
Cómo es el error
Un error típico del nivel gratuito, publicado en el foro para desarrolladores de Google, tiene estas partes:
Ejemplo de 429 del nivel gratuito
429 RESOURCE_EXHAUSTED
You exceeded your current quota, please check your plan and billing details.
Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 50
quotaId: GenerateRequestsPerDayPerProjectPerModel-FreeTier
Please retry in 11.615098148s.quotaMetricindica qué se agotó.generate_content_free_tier_requestscuenta las solicitudes del nivel gratuito.quotaIdindica la ventana.PerDayes la cuota diaria. Un IDPerMinutees el límite por minuto.limites su cuota para ese modelo en esa ventana.Please retry inindica el tiempo de espera que sugiere Google.
Los tres códigos 429 y un 403
La página de errores de la API de Google lista tres códigos de error con HTTP 429, y un 403 relacionado:
| Código | HTTP | Significado | Solución |
|---|---|---|---|
rate_limit_exceeded | 429 | Se alcanzó el límite de solicitudes o de tokens por minuto o por segundo | Reintente con retroceso exponencial |
quota_exceeded | 429 | Se agotó la cuota diaria | Espere al restablecimiento, o solicite un aumento |
too_many_requests | 429 | Demasiadas solicitudes en un intervalo corto | Reintente con retroceso exponencial |
permission_denied | 403 | El proyecto está restringido, o el nivel gratuito no está disponible para él | Vincule una cuenta de facturación y use el nivel de pago |
Un límite por minuto se libera en menos de un minuto. Una cuota diaria solo se libera en el restablecimiento. Google restablece las solicitudes diarias a medianoche, hora del Pacífico. Reintentar un error de cuota diaria antes del restablecimiento desperdicia solicitudes.
Límites del nivel gratuito hoy
Google aplica los límites a cada proyecto de Google Cloud, no a cada clave. Los límites son distintos para cada modelo. Google muestra sus límites activos en AI Studio. La tabla muestra los límites gratuitos de Gemini y Gemma en el catálogo de FreeLLMAPI.
| Modelo | Gratis en | Contexto | Límites gratuitos (mejor oferta) | Herramientas | Visión |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sí | Sí |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Gemini 3.8 Live | Google AI Studio | - | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | No | No |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | No | No |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | No | Sí |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
Se muestran 12 de 21 modelos gratuitos que coinciden. Ver todos los modelos.
Datos en vivo del catálogo de FreeLLMAPI (versión 2026.11.19, revisado 2026-11-19). Los límites gratuitos cambian con frecuencia. El catálogo se revisa todos los días.
La mayoría de los modelos Flash permiten unas 20 solicitudes al día en el nivel gratuito. Los modelos Gemma permiten muchas más solicitudes al día, pero tienen una ventana de contexto más pequeña. Google indica que los límites especificados no están garantizados y que la capacidad real puede variar.
Soluciones que funcionan
- Lea el
quotaId. Si contienePerDay, deténgase y espere al restablecimiento a medianoche, hora del Pacífico. - Para un límite por minuto, reintente con retroceso exponencial y jitter. Defina un número máximo de reintentos.
- Pase las tareas sencillas a un modelo con un tope diario más alto, por ejemplo un modelo Gemma o Flash-Lite.
- Envíe menos tokens. Los prompts grandes alcanzan rápido el límite de tokens por minuto.
- No use un
max_tokensmuy pequeño. Gemini Flash puede usar tokens de razonamiento ocultos dentro del límite de salida.
| Lo que prueba | ¿Ayuda? | Por qué |
|---|---|---|
| Crear una clave de API nueva en el mismo proyecto | No | Los límites se aplican al proyecto. Google indica que una clave nueva no resuelve el error. |
| Pasar el proyecto al nivel de pago | Da cuota de pago | Google indica que el nivel de pago no le da cuota del nivel gratuito. El uso de pago se factura. |
Esperar el tiempo de retry in | Sí, para los límites por minuto | La ventana de minuto se renueva |
| Cambiar a otro modelo | Sí | Cada modelo tiene su propia cuota |
Compruebe su cuota antes de enviar
Puede ver el problema antes del error. En AI Studio, abra la página de límites de velocidad de la documentación de Gemini. Muestra los límites activos de su proyecto para cada modelo. La página Projects muestra su nivel.
Si usa FreeLLMAPI, pregunte a la pasarela qué modelos están listos ahora. Un modelo con el estado exhausted tiene claves que están todas en espera. Ese estado desaparece solo cuando terminan las esperas.
Listar los modelos que pueden responder ahora
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Planifique su uso diario con números sencillos. Con 20 solicitudes al día, un modelo Flash le da una solicitud cada 72 minutos durante un día completo. Un agente de programación puede usar 20 solicitudes en una sola tarea. Reserve los modelos Flash solo para tareas difíciles, y envíe las tareas sencillas a modelos con topes diarios más altos.
Conmutar a otros proveedores gratuitos
Con unas 20 solicitudes Flash al día, una sola clave de Gemini no basta para el trabajo con agentes. FreeLLMAPI pone Gemini detrás de un endpoint junto con otros proveedores gratuitos. Cuando Gemini envía un 429, el enrutador envía la solicitud al siguiente modelo de su cadena.
- El enrutador cuenta RPM, RPD, TPM y TPD para cada modelo y cada clave. Se detiene antes de llegar a un límite conocido.
- Un 429 corto deja la clave en espera de 90 segundos. Una cuota diaria agotada usa una espera más larga: 2 minutos, 10 minutos, 1 hora y después 24 horas.
- Si Google da un tiempo de reintento más largo, el enrutador usa el valor de Google.
- La cabecera
X-Fallback-Trailenumera cada salto fallido, por ejemplogoogle/gemini-2.5-flash key1=rate_limited.
Enviar el tráfico de Gemini por la pasarela
curl -fsSL https://freellmapi.co/install.sh | bash
curl -i http://localhost:3001/v1/chat/completions \
-H "Authorization: Bearer <unified-key>" \
-H "Content-Type: application/json" \
-d '{"model": "auto", "messages": [{"role": "user", "content": "hi"}]}'Gemini CLI también puede usar la superficie nativa /v1beta de la pasarela. La pasarela no añade cuota de Gemini. Usa otros proveedores cuando Gemini está en su límite.
Particularidades conocidas de Gemini
| Proveedor | Problema conocido | Qué hacer |
|---|---|---|
| Google AI Studio | Thinking tokens use output cap | Gemini Flash can spend hidden thinking tokens inside maxOutputTokens. Avoid tiny max_tokens values or set thinkingBudget to 0 when provider support is available. |
Datos en vivo del catálogo de FreeLLMAPI (versión 2026.11.19, revisado 2026-11-19). Los límites gratuitos cambian con frecuencia. El catálogo se revisa todos los días.
Preguntas frecuentes
¿Qué significa 429 RESOURCE_EXHAUSTED en la API de Gemini?
Significa que su proyecto superó un límite de velocidad o una cuota. El quotaId del cuerpo del error indica si es un límite por minuto o una cuota diaria.
¿Cuándo se restablece la cuota del nivel gratuito de Gemini?
Las solicitudes diarias se restablecen a medianoche, hora del Pacífico. Los límites por minuto se restablecen en un minuto.
¿Por qué una clave nueva de la API de Gemini no soluciona el error de cuota?
Google aplica los límites al proyecto de Google Cloud, no a la clave. Todas las claves del mismo proyecto comparten la misma cuota.
¿Qué significa limit: 0 en un error de cuota de Gemini?
Significa que su proyecto no tiene cuota gratuita para ese modelo en esa ventana. Algunos proyectos no son elegibles para el nivel gratuito. Compruebe sus límites en AI Studio o pruebe otro modelo.
¿Cómo evito los errores 429 de Gemini en un agente de programación?
Use varios proveedores gratuitos detrás de una sola pasarela. Cuando Gemini llega a su límite, la pasarela envía la solicitud a otro proveedor, así que el agente sigue funcionando.
Guías relacionadas
- Límites de uso de API LLM gratuitas
- free gemini api
- Gemini CLI con un endpoint personalizado y modelos gratuitos
- Límite de uso de Groq alcanzado (429)
- Límite de uso de la API NVIDIA NIM
Fuentes
- Google AI Studio: Rate limits (revisado 20 November 2026)
- Google AI Studio: API errors (revisado 20 November 2026)
- Google AI Studio: Troubleshooting (revisado 20 November 2026)
- Google developer forum: free tier quota error example (revisado 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (revisado 20 November 2026)
- FreeLLMAPI docs: Response headers (revisado 20 November 2026)