Inicio / Guías / Cuota de la API de Gemini superada (429 RESOURCE_EXHAUSTED)

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.
  • quotaMetric indica qué se agotó. generate_content_free_tier_requests cuenta las solicitudes del nivel gratuito.
  • quotaId indica la ventana. PerDay es la cuota diaria. Un ID PerMinute es el límite por minuto.
  • limit es su cuota para ese modelo en esa ventana.
  • Please retry in indica 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:

De la página de errores de la API de Gemini
CódigoHTTPSignificadoSolución
rate_limit_exceeded429Se alcanzó el límite de solicitudes o de tokens por minuto o por segundoReintente con retroceso exponencial
quota_exceeded429Se agotó la cuota diariaEspere al restablecimiento, o solicite un aumento
too_many_requests429Demasiadas solicitudes en un intervalo cortoReintente con retroceso exponencial
permission_denied403El proyecto está restringido, o el nivel gratuito no está disponible para élVincule 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.

Límites gratuitos de Gemini y Gemma del catálogo actual
ModeloGratis enContextoLímites gratuitos (mejor oferta)HerramientasVisión
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSí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 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Gemini 3.6 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Gemini 3.5 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Gemini 3.8 LiveGoogle AI Studio-10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Gemini 3.8 Flash TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNoNo
Gemini 3.8 Flash-Lite TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyNoNo
Gemini Robotics-ER 2 PreviewGoogle AI Studio131K10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
NoSí
Gemini 3.5 Flash LiteGoogle AI Studio1M15 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

  1. Lea el quotaId. Si contiene PerDay, deténgase y espere al restablecimiento a medianoche, hora del Pacífico.
  2. Para un límite por minuto, reintente con retroceso exponencial y jitter. Defina un número máximo de reintentos.
  3. Pase las tareas sencillas a un modelo con un tope diario más alto, por ejemplo un modelo Gemma o Flash-Lite.
  4. Envíe menos tokens. Los prompts grandes alcanzan rápido el límite de tokens por minuto.
  5. No use un max_tokens muy 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 proyectoNoLos límites se aplican al proyecto. Google indica que una clave nueva no resuelve el error.
Pasar el proyecto al nivel de pagoDa cuota de pagoGoogle indica que el nivel de pago no le da cuota del nivel gratuito. El uso de pago se factura.
Esperar el tiempo de retry inSí, para los límites por minutoLa ventana de minuto se renueva
Cambiar a otro modeloSí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-Trail enumera cada salto fallido, por ejemplo google/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

ProveedorProblema conocidoQué hacer
Google AI StudioThinking tokens use output capGemini 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.

Use cada uno de estos modelos con una sola clave. FreeLLMAPI es un enrutador de código abierto y autoalojado. Reúne todos estos niveles gratuitos detrás de un único endpoint compatible con OpenAI y cambia de proveedor cuando uno alcanza su límite. Explore el catálogo o ir en vivo.

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

Fuentes

Todas las guías · Ver todos los modelos gratuitos