Error timeout: qué hacer cuando falla gemini-2.5-pro

Un timeout significa que el cliente se rindió antes de recibir la respuesta. Las solicitudes con streaming a LLM son las que más lo sufren, porque el modelo piensa antes del primer token y esa fase no produce ningún byte.

Un timeout no es un código de estado HTTP, sino un límite de espera del cliente. La solicitud normalmente llegó al gateway y se reenvió al upstream, pero el modelo no generó resultado dentro del tiempo que fijaste. Contexto largo, salida larga y llamadas sin streaming son los tres detonantes más comunes.

gemini-2.5-pro lo ofrece Google. Todo en esta página — causas, soluciones y datos medidos — se recopila del comportamiento real de este modelo en la capa de gateway.

En esta pasarela, el desencadenante más común es: El timeout del cliente es demasiado bajo. La primera acción recomendada es: Sube el timeout del cliente a 300 segundos o más.

Causas habituales

• El timeout del cliente es demasiado bajo
• Un prompt o contexto largo eleva la latencia del primer token
• El modelo está resolviendo una tarea de razonamiento larga
• Fluctuaciones de red

Cómo solucionarlo

• Sube el timeout del cliente a 300 segundos o más
• Activa el streaming para no esperar la respuesta completa
• Acorta el contexto o usa un modelo más rápido
• Baja max_tokens

Reintento con retroceso exponencial

El siguiente código reintenta cuando gemini-2.5-pro devuelve timeout: hasta 5 intentos, con espera creciente y jitter aleatorio para que las llamadas concurrentes no reintenten a la vez. Lee la URL base y la API key de variables de entorno, nunca las escribas fijas.

import os, time, random
import requests

BASE  = os.getenv("OPENAI_BASE_URL")   # e.g. https://<your-gateway>/v1
KEY   = os.getenv("OPENAI_API_KEY")
MODEL = 'gemini-2.5-pro'


def chat(messages, retries=5):
    """Retry with exponential backoff + jitter."""
    for i in range(retries):
        try:
            r = requests.post(
                BASE + "/chat/completions",
                headers={"Authorization": "Bearer " + KEY},
                json={"model": MODEL, "messages": messages, "stream": True},
                timeout=60,
            )
            if r.status_code == 429 or r.status_code >= 500:
                time.sleep(min(2 ** i + random.uniform(0, 1), 30))
                continue
            r.raise_for_status()
            return r.json()
        except requests.exceptions.Timeout:
            time.sleep(min(2 ** i + random.uniform(0, 1), 30))
    raise RuntimeError("gave up after " + str(retries) + " retries")


print(chat([{"role": "user", "content": "hello"}]))

Datos clave de este modelo

Preguntas frecuentes

Otros errores de este modelo

• gemini-2.5-pro: error 429 — causas y soluciones
• gemini-2.5-pro: error 500 — causas y soluciones
• gemini-2.5-pro: error 502 — causas y soluciones
• gemini-2.5-pro: error 503 — causas y soluciones
• gemini-2.5-pro: error 504 — causas y soluciones
• gemini-2.5-pro: error 401 — causas y soluciones
• gemini-2.5-pro: error 403 — causas y soluciones
• gemini-2.5-pro: error 400 — causas y soluciones

Otros modelos con el mismo error

• gpt-5
• claude-opus-5
• deepseek-v4-pro
• grok-4.3
• llama-3.3-70b-instruct
• qvq-max
• qwq-32b
• glm-5
• MiniMax-M3
• kimi-k3
• hy3
• doubao-seed-evolving
• mimo-v2.5
• gpt-4o
• claude-opus-4-6
• gemini-2.5-flash

Volver a la página del modelo

Datos actualizados: 2026-10-10 12:10