Si Gemini muestra alta demanda, high demand, modelo saturado o un 503, no empieces cambiando el prompt, limpiando el navegador o subiendo de plan. Primero identifica dónde aparece: Gemini App, Gemini CLI, Gemini API o una ruta de image preview. Cada superficie tiene dueño, evidencia y recuperación distinta.
Después mira la clase de error. Un 503 suele indicar capacidad temporal, modelo sobrecargado o backend no disponible. Un 429 apunta a cuota o rate limit. Un 504 apunta a timeout o presupuesto de ejecución. Mezclar esas ramas convierte un problema temporal en cambios innecesarios de cuenta o código.
El 24 de abril de 2026 se contrastaron la documentación de Gemini API, los resultados visibles en español e inglés y reportes públicos de usuarios de CLI/API. El orden útil es simple: superficie, estado, un reintento acotado por la misma ruta, y luego espera, cola, fallback deliberado o evidencia para soporte.
Empieza con el tablero de rutas
Usa el mensaje como alarma, no como diagnóstico final.
| Superficie | Qué suele significar | Primer movimiento | Regla de parada |
|---|---|---|---|
| Gemini App o Advanced | Ruta de modelo ocupada, problema de interfaz o plan no reconocido. | Revisa modelo seleccionado, plan visible y estado oficial. | No pagues otra vez por un solo aviso de congestión. |
| Gemini CLI | Modelo por defecto, Code Assist o respuesta del proveedor envuelta por la CLI. | Repite el mismo comando una vez y registra modelo, auth y versión. | No cambies el código del proyecto antes de conocer el dueño. |
| Gemini API | La clase HTTP pesa más que la frase. | Separa 503, 429 y 504 antes de tocar código. | Sal de esta rama si el código cambia a 429 o 504. |
| Image preview | La generación de imágenes puede saturarse aparte del texto. | Mantén la misma ruta y reintenta con límite. | Usa la rama de image 503 cuando esté confirmada. |
Este tablero evita el error más común: tratar capacidad de servicio como fallo local. Si la ruta del modelo está saturada, borrar caché o cambiar prompt no demuestra reparación. Si el error real es 429, esperar por capacidad tampoco resuelve la cuota.
Para API, mantén abierta la guía de troubleshooting de Gemini API. Si confirmas que la falla es de generación de imágenes, sigue con la guía específica de Gemini image 503 overloaded.
Confirma la superficie antes de reintentar
El error de alta demanda en Gemini no pertenece a un solo contrato. App, CLI, API e image route tienen evidencia distinta.
En Gemini App, revisa modelo visible, plan, cuenta conectada, navegador o móvil. Si Pro aparece ocupado pero un modelo más rápido funciona, estás ante capacidad de una ruta de modelo, no necesariamente ante un 503 de developer API.
En Gemini CLI, registra comando, versión de CLI, método de autenticación, modelo por defecto y momento en que aparece el error. Si ocurre antes de cualquier respuesta útil del modelo, sospecha primero de la ruta del modelo o de la cuenta, no del repositorio.
En Gemini API, los logs mandan: HTTP code, status, model id, timestamp, request id, región o ruta de proveedor y resultado de un reintento por la misma ruta. Cambiar modelo, SDK, timeout y payload a la vez destruye la señal.
La ruta de imágenes se analiza aparte. Un texto que responde bien no prueba que image preview esté sano. Una imagen fallida no prueba que todo Gemini esté caído.
API: 503 no es 429 ni 504
Si trabajas por API, lee primero el estado.
| Clase | Significado práctico | Mejor primer movimiento |
|---|---|---|
| 503 UNAVAILABLE u overloaded | Capacidad temporal, modelo sobrecargado o backend unavailable. | Reintento por la misma ruta con backoff acotado. |
| 429 RESOURCE_EXHAUSTED | Cuota, rate limit, billing tier o frecuencia. | Reducir ritmo y abrir la rama de límites. |
| 504 DEADLINE_EXCEEDED | Timeout, payload pesado o presupuesto temporal. | Ajustar timeout, reducir carga y volver a probar. |
El primer reintento debe conservar model id, endpoint, auth owner y payload esencial. Si pasa, la capacidad temporal es plausible. Si sigue en 503, espera, pon en cola o usa un fallback decidido. Si se convierte en 429 o 504, ya no es la misma rama.
El patrón peligroso es cambiar modelo, SDK, timeout y prompt a la vez. Puede generar un éxito aislado, pero no explica el dueño. En producción conviene una prueba pequeña y repetible.
Para límites usa Gemini API rate limits guide. Para fallos de API más amplios, usa Gemini API error troubleshooting.
CLI: un reintento y después decisión de calidad
Gemini CLI junta entorno local, auth, modelo y ruta API en una sola experiencia. Por eso el mensaje corto de high demand no debe enviarte directo a modificar código local.
Repite el mismo comando una vez. Guarda hora, comando, modelo mostrado, auth y si los tool calls ya habían empezado. Si el error aparece antes de una respuesta útil, el dueño más probable es la ruta del modelo o la cuenta.
Luego decide si puedes bajar de modelo. Para una explicación simple puede servir. Para generación de código o refactor, una salida más débil puede costar más que esperar unos minutos.
Si la instalación o el login de la CLI son inciertos, separa ese problema con Gemini CLI install guide. No mezcles instalación con capacidad en vivo.
App y usuarios de pago
Un plan de pago puede mejorar prioridad, pero no garantiza acceso absoluto durante cada pico. En la rama de pago, la primera pregunta es si la cuenta y el plan correctos están reconocidos.
Revisa plan visible, cuenta, modelo seleccionado, superficie web/mobile y estado oficial. Si Pro está ocupado y un modelo rápido funciona, es capacidad de ruta. Si el plan no aparece, puede ser reconocimiento de cuenta o entitlement.
Antes de soporte, prepara:
- captura del mensaje；
- timestamp y timezone；
- superficie: App, Web, mobile, CLI, API o image route；
- modelo seleccionado y plan visible；
- estado oficial en ese momento；
- resultado de un reintento por la misma ruta；
- resultado de otra superficie oficial si existe.
Este paquete separa salud del servicio, capacidad de ruta, plan y forma de la petición. También reduce el riesgo de pagar dos veces por una congestión temporal.
Image preview y fallos tipo Nano Banana
La generación de imágenes usa otra capacidad y puede fallar de forma aislada. Gemini texto puede responder mientras image preview devuelve 503.
Si la ruta de imagen dice overloaded o high demand, conserva la ruta para el primer reintento. No cambies prompt, aspecto, SDK, modelo y batch al mismo tiempo. Comprueba el request esencial, aplica backoff y solo después reduce batch o manda a cola.
Para un image 503 confirmado, usa Fix Gemini 3 Pro Image 503 Errors. Esa rama se centra en code/status de image generation, no en banners de la app.
Cuándo esperar, cambiar o escalar
| Situación | Siguiente paso | Motivo |
|---|---|---|
| El reintento por la misma ruta funciona | Continuar y monitorizar. | Capacidad temporal probable. |
| La misma ruta sigue en 503 | Esperar, poner en cola o usar fallback. | La capacidad no se recuperó en la ventana corta. |
| Cambia a 429 | Ir a cuota y rate limit. | Ya es otra rama. |
| Cambia a 504 o client timeout | Ajustar timeout. | Reintentar no arregla el presupuesto temporal. |
| Usuario de pago ve upgrade prompt | Verificar cuenta y plan. | Puede ser entitlement, no capacidad. |
Escala solo cuando puedas describir la ruta. Modelo, superficie, estado, hora, cuenta y resultado de reintento producen mejor respuesta que una queja general.
Preguntas frecuentes
Qué significa alta demanda en Gemini?
Significa que la ruta actual de Gemini no pudo servir la petición en ese momento. No prueba por sí solo que tu cuenta, prompt, navegador o código estén rotos.
503 high demand es lo mismo que rate limit?
No. 503 suele ser capacidad temporal o backend unavailable. 429 corresponde a cuota o límites.
Debería subir de plan?
No como primer movimiento. Revisa estado, modelo, plan visible y un reintento por la misma ruta.
Por qué Gemini CLI repite high demand?
Puede estar golpeando un modelo por defecto ocupado o una respuesta envuelta por la CLI. Registra comando, versión, auth, modelo, hora y un reintento.
Cambiar de modelo lo arregla?
Puede servir como fallback si aceptas otro perfil de calidad. No conviene como primera prueba diagnóstica.
Regla final
El error de alta demanda en Gemini es primero un problema de enrutamiento. Identifica superficie, lee estado, reintenta una vez por la misma ruta y luego elige espera, cola, fallback o evidencia para soporte.