RESOURCE_EXHAUSTED es el error 429 general de Gemini. Si desaparece después de un minuto, alcanzaste un límite de velocidad: el backoff lo soluciona. Si dura hasta la medianoche del Pacífico, agotaste una cuota diaria del nivel gratuito: ningún bucle de reintento puede solucionarlo; solo la facturación o una ruta distinta.
El error
{
"error": {
"code": 429,
"message": "Resource has been exhausted (e.g. check quota).",
"status": "RESOURCE_EXHAUSTED"
}
}Causas y soluciones de un vistazo
| Causa | Solución |
|---|---|
| Límite de velocidad por minuto (RPM/TPM) | Aplica backoff con jitter y suaviza los picos. Se resuelve en unos 60 s. |
| Cuota diaria de solicitudes del nivel gratuito agotada | Espera hasta el reinicio diario; activa la facturación, aumenta la cuota o enruta mediante una pasarela de pago. |
| Muchos workers comparten una clave | La cuota es por proyecto, no por worker: centraliza un limitador de velocidad o distribuye la carga entre proyectos/claves. |
Clasifica: límite por minuto o cuota diaria
Reintenta una vez después de 60 segundos. Éxito → límite de velocidad de escala de minutos (añade backoff y continúa). Sigue en 429 → cuota diaria; comprueba Cloud Console → Quotas para ver el contador exacto que está al 100 %.
Para límites por minuto: el backoff estándar
El mismo patrón que para cualquier 429: exponencial, con jitter y reintentos solo para estados reintentables. Reutiliza sin cambios el fragmento de nuestra guía sobre errores 429 de Claude; es independiente del proveedor.
Para cuotas diarias: cambia la economía
Las cuotas del nivel gratuito sirven para prototipos. Producción necesita la facturación activada en el proyecto, o una pasarela de pago por uso donde el límite sea tu presupuesto y no un contador diario. Compara el coste por token antes de elegir.
Si llamas a través de Kunavo
En Kunavo, Gemini 2.5 Flash/Pro funciona con pago por uso mediante una única cartera prepago: no existe un contador diario del nivel gratuito que agotar y las solicitudes fallidas no se facturan. Para cargas de trabajo que chocan continuamente con las cuotas diarias de AI Studio, el precio por token (muy inferior al de Google) suele ser más barato que el tiempo de ingeniería dedicado a distribuir la carga entre proyectos.
Preguntas frecuentes
¿Cuándo se restablece la cuota del nivel gratuito de Gemini?
Las cuotas diarias se restablecen a medianoche, hora del Pacífico. Los límites por minuto se restablecen mediante una ventana móvil de 60 segundos.
¿El backoff solucionará RESOURCE_EXHAUSTED?
Solo el error del tipo de límite por minuto. Una cuota diaria agotada devuelve 429 en cada reintento hasta el reinicio; detecta ese caso (429 persistente después de esperar 60 s) y deja de consumir reintentos inútiles.
Guías relacionadas
Encontrarás más detalles sobre el significado de los errores en referencia de errores; obtener una clave lleva un minuto mediante registro y la guía de autenticación.