---
title: "¿Qué es un timeout de solicitud? Timeouts en APIs de LLM"
description: "Un timeout es cuánto espera un cliente a una API de LLM antes de rendirse. Timeouts de conexión y lectura, valores del SDK, 408 y 504, y reintentos seguros."
url: https://broadrouter.com/es/glossary/request-timeout/
lang: es
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/glossary/request-timeout/) (actualizado el 2026-11-15).

# Timeout de solicitud (tiempo de espera)

Actualizado 2026-11-15

Un timeout de solicitud es el tiempo máximo que un cliente HTTP espera a un servidor antes de abandonar la solicitud. Los clientes suelen dividirlo en un timeout de conexión, para abrir la conexión, y uno de lectura, para esperar los datos. Las llamadas a LLMs necesitan timeouts de lectura generosos porque las respuestas largas tardan.

También llamado: timeout, tiempo de espera, tiempo de espera agotado, timeout de lectura, timeout de conexión, request timeout, read timeout, connect timeout, client timeout, HTTP timeout

Toda llamada de red necesita un punto en el que se deja de esperar. En las llamadas a un LLM ese punto es difícil de elegir, porque una respuesta lenta y una conexión muerta se ven iguales durante un rato.

## Cómo funciona

Los clientes HTTP dividen la espera en fases. HTTPX, un cliente HTTP habitual en Python, tiene cuatro:

| Timeout | Significado en HTTPX | Error |
| --- | --- | --- |
| Conexión (connect) | Tiempo máximo para establecer una conexión de socket | `ConnectTimeout` |
| Lectura (read) | Espera máxima por un fragmento de datos entrantes | `ReadTimeout` |
| Escritura (write) | Espera máxima para enviar un fragmento del cuerpo de la solicitud | `WriteTimeout` |
| Pool | Espera máxima por una conexión del pool | `PoolTimeout` |

HTTPX, sin configurar, agota el tiempo tras cinco segundos de inactividad de red. El SDK de OpenAI para Python fija su propio valor: “By default requests time out after 10 minutes” (traducción: por defecto, las solicitudes agotan el tiempo de espera a los 10 minutos), lanza `APITimeoutError` y reintenta dos veces una solicitud que agotó el tiempo. También reintenta por defecto los errores de conexión y las respuestas 408, 409, 429 y 5xx.

```python
from openai import OpenAI
client = OpenAI(base_url="https://inference.broadnet.ai/v1", timeout=120.0, max_retries=2)
```

Los servidores también tienen timeouts. MDN define 504 Gateway Timeout como un gateway o proxy que “did not get a response in time from the upstream server” (traducción: no recibió a tiempo una respuesta del servidor de origen), y 408 Request Timeout como el servidor que quiere “to shut down this unused connection” (traducción: cerrar esta conexión sin uso).

## Por qué importa

-   **Los modelos de razonamiento tardan en empezar.** El razonamiento ocurre antes del primer token visible. Un timeout de lectura corto en una llamada sin streaming puede cortar una solicitud sana.
-   **Los streams detectan bloqueos.** Con [streaming](https://broadrouter.com/es/glossary/streaming/), cada fragmento reinicia el temporizador de lectura, así que un bloqueo se nota rápido incluso en una respuesta larga.
-   **Los reintentos pueden duplicar el costo.** Un timeout no significa que el servidor se haya detenido. Reintentar una solicitud que sigue en ejecución puede cobrarse dos veces. Use [backoff exponencial](https://broadrouter.com/es/glossary/exponential-backoff/) con un tope, y una [clave de idempotencia](https://broadrouter.com/es/glossary/idempotency-key/) donde la API la admita.

## En BroadNet Inference

La [referencia de la API de BroadNet](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-glossary-request-timeout&utm_content=body) indica leer un stream hasta `data: [DONE]`. Si la conexión termina antes, “treat the response as incomplete, record the X-Request-ID” (traducción: trate la respuesta como incompleta y registre el X-Request-ID), y decida si su aplicación puede enviar una nueva solicitud con seguridad. Para 500, 502, 503 y 504 indica reintentar con backoff exponencial acotado; un 429 significa que se alcanzó un límite de frecuencia, de concurrencia, de tokens por minuto o de gasto. Conserve el X-Request-ID para soporte. La [guía de errores y reintentos](https://broadrouter.com/es/guides/errors-and-retries/) y el [artículo sobre agentes de larga duración](https://broadrouter.com/es/blog/long-running-agents-timeouts-retries/) muestran configuraciones que funcionan.

## Errores comunes

-   Dejar el valor predeterminado y preguntarse por qué una llamada colgada bloquea un worker durante diez minutos.
-   Reintentar sin tope, de modo que un minuto malo se convierte en una avalancha de solicitudes.

## Preguntas frecuentes

### ¿Cuál es el timeout predeterminado del SDK de OpenAI para Python?

Su README dice que "By default requests time out after 10 minutes" (traducción: por defecto, las solicitudes agotan el tiempo de espera a los 10 minutos), y las solicitudes que lo agotan se reintentan dos veces por defecto con un backoff exponencial corto.

### ¿Debo usar el mismo timeout para todas las llamadas al LLM?

No. Una llamada corta de clasificación y una respuesta larga de razonamiento necesitan límites distintos. Con streaming, un timeout de lectura sobre el intervalo entre fragmentos detecta los bloqueos mejor que un único límite total largo.

### ¿Qué hago cuando un stream de BroadNet se detiene antes de tiempo?

BroadNet indica tratar como incompleto un stream que termina antes de data: \[DONE\], registrar el X-Request-ID y decidir si su aplicación puede enviar una nueva solicitud con seguridad.

## Vea también

-   [Backoff exponencial (exponential backoff)](https://broadrouter.com/es/glossary/exponential-backoff/) (término)
-   [Streaming (respuestas en tiempo real)](https://broadrouter.com/es/glossary/streaming/) (término)
-   [Latencia (latency)](https://broadrouter.com/es/glossary/latency/) (término)
-   [Clave de idempotencia (idempotency key)](https://broadrouter.com/es/glossary/idempotency-key/) (término)
-   [Límite de frecuencia (rate limit)](https://broadrouter.com/es/glossary/rate-limit/) (término)
-   [Fallback de modelos (model fallback)](https://broadrouter.com/es/glossary/model-fallback/) (término)
-   [Códigos de error de BroadNet Inference y cuándo reintentar](https://broadrouter.com/es/guides/errors-and-retries/) (guía)
-   [Streaming de chat completions y conexiones interrumpidas](https://broadrouter.com/es/guides/streaming-chat-completions/) (guía)
-   [Usar el SDK de OpenAI para Python con BroadNet Inference](https://broadrouter.com/es/guides/openai-python-sdk/) (guía)
-   [Agentes de larga duración: timeouts, reintentos y checkpoints sólidos](https://broadrouter.com/es/blog/long-running-agents-timeouts-retries/) (artículo)
-   [Cómo manejar el 429 de una API de LLM: backoff, jitter y limitadores](https://broadrouter.com/es/blog/handle-llm-api-429-rate-limits/) (artículo)

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

[Comenzar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-glossary-request-timeout&utm_content=page-cta) ·

**Fuentes**

-   [README del SDK de OpenAI para Python, timeouts y reintentos (consultado el 2026-11-15)](https://github.com/openai/openai-python)
-   [Documentación de HTTPX, timeouts (consultado el 2026-11-15)](https://www.python-httpx.org/advanced/timeouts/)
-   [MDN, 504 Gateway Timeout (consultado el 2026-11-15)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/504)
-   [MDN, 408 Request Timeout (consultado el 2026-11-15)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/408)
-   [Referencia de la API de BroadNet Inference, streaming y errores (consultado el 2026-11-15) (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-glossary-request-timeout&utm_content=sources)
