---
title: "Qu’est-ce qu’un timeout de requête ? Les appels d’API LLM"
description: "Un timeout de requête fixe combien de temps un client attend une API de LLM. Timeouts de connexion et de lecture, valeurs des SDK, 408 et 504, et retries sûrs."
url: https://broadrouter.com/fr/glossary/request-timeout/
lang: fr
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduit de l’anglais avec l’aide de l’IA. [Lire l’original en anglais](https://broadrouter.com/glossary/request-timeout/) (mis à jour le 2026-11-15).

# Timeout de requête (délai d’expiration)

Mis à jour 2026-11-15

Un timeout de requête est la durée maximale pendant laquelle un client HTTP attend un serveur avant d’abandonner la requête. Les clients le divisent souvent en un timeout de connexion, pour ouvrir la connexion, et un timeout de lecture, pour attendre les données. Les appels de LLM exigent des timeouts de lecture généreux, car les longues réponses prennent du temps.

Aussi appelé : timeout, timeout de requête, délai d’expiration, délai d’attente, timeout de lecture, timeout de connexion, request timeout, read timeout, connect timeout, client timeout, HTTP timeout

Tout appel réseau a besoin d’un moment où l’on cesse d’attendre. Pour les appels de LLM, ce moment est difficile à choisir, car une réponse lente et une connexion morte se ressemblent pendant un certain temps.

## Comment ça marche

Les clients HTTP découpent l’attente en phases. HTTPX, un client HTTP Python répandu, en compte quatre :

| Timeout | Signification dans HTTPX | Erreur |
| --- | --- | --- |
| Connect | Durée maximale pour établir une connexion socket | `ConnectTimeout` |
| Read | Attente maximale d’un bloc de données entrantes | `ReadTimeout` |
| Write | Attente maximale pour envoyer un bloc du corps de la requête | `WriteTimeout` |
| Pool | Attente maximale d’une connexion disponible dans le pool | `PoolTimeout` |

Par défaut, HTTPX seul expire après cinq secondes d’inactivité réseau. Le SDK Python d’OpenAI fixe sa propre valeur par défaut : « By default requests time out after 10 minutes » (traduction : « par défaut, les requêtes expirent au bout de 10 minutes »), lève `APITimeoutError` et relance deux fois une requête expirée. Il relance aussi par défaut les erreurs de connexion et les réponses 408, 409, 429 et 5xx.

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

Les serveurs ont aussi leurs timeouts. MDN définit le 504 Gateway Timeout comme une passerelle ou un proxy qui « did not get a response in time from the upstream server » (traduction : « n’a pas reçu de réponse à temps du serveur en amont »), et le 408 Request Timeout comme un serveur qui souhaite « to shut down this unused connection » (traduction : « fermer cette connexion inutilisée »).

## Pourquoi c’est important

-   **Les modèles de raisonnement démarrent lentement.** La réflexion a lieu avant le premier token visible. Un timeout de lecture court sur un appel sans streaming peut couper une requête en bonne santé.
-   **Les flux révèlent les blocages.** En [streaming](https://broadrouter.com/fr/glossary/streaming/), chaque chunk remet à zéro le minuteur de lecture : un blocage se voit vite, même sur une longue réponse.
-   **Les retries peuvent doubler le coût.** Un timeout ne signifie pas que le serveur s’est arrêté. Relancer une requête encore en cours peut être facturé deux fois. Utilisez un [backoff exponentiel](https://broadrouter.com/fr/glossary/exponential-backoff/) plafonné, et une [clé d’idempotence](https://broadrouter.com/fr/glossary/idempotency-key/) quand l’API en propose une.

## Sur BroadNet Inference

La [référence de l’API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-glossary-request-timeout&utm_content=body) de BroadNet demande de lire un flux jusqu’à `data: [DONE]`. Si la connexion se termine avant, il faut « treat the response as incomplete, record the X-Request-ID » (traduction : « considérer la réponse comme incomplète et noter le X-Request-ID »), puis décider si votre application peut sans risque envoyer une nouvelle requête. Pour les erreurs 500, 502, 503 et 504, elle recommande de relancer avec un backoff exponentiel borné ; un 429 signifie qu’une limite de débit, de concurrence, de tokens par minute ou de dépense a été atteinte. Conservez le X-Request-ID pour le support. Le [guide des erreurs et des retries](https://broadrouter.com/fr/guides/errors-and-retries/) et l’[article sur les agents de longue durée](https://broadrouter.com/fr/blog/long-running-agents-timeouts-retries/) montrent des réglages qui fonctionnent.

## Erreurs fréquentes

-   Garder la valeur par défaut et se demander pourquoi un appel bloqué immobilise un worker pendant dix minutes.
-   Relancer sans plafond, si bien qu’une mauvaise minute se transforme en déluge de requêtes.

## Questions fréquentes

### Quel est le timeout par défaut du SDK Python d’OpenAI ?

Son README indique « By default requests time out after 10 minutes » (traduction : « par défaut, les requêtes expirent au bout de 10 minutes »), et les requêtes expirées sont relancées deux fois par défaut avec un court backoff exponentiel.

### Faut-il un seul timeout pour tous les appels de LLM ?

Non. Un court appel de classification et une longue réponse de raisonnement demandent des limites différentes. En streaming, un timeout de lecture sur l’intervalle entre deux chunks détecte mieux les blocages qu’une seule longue limite totale.

### Que faire quand un flux BroadNet s’arrête trop tôt ?

BroadNet indique de considérer comme incomplet un flux qui se termine avant data: \[DONE\], de noter le X-Request-ID et de décider si votre application peut sans risque envoyer une nouvelle requête.

## Voir aussi

-   [Backoff exponentiel (exponential backoff)](https://broadrouter.com/fr/glossary/exponential-backoff/) (terme)
-   [Streaming](https://broadrouter.com/fr/glossary/streaming/) (terme)
-   [Latence (LLM)](https://broadrouter.com/fr/glossary/latency/) (terme)
-   [Clé d’idempotence (idempotency key)](https://broadrouter.com/fr/glossary/idempotency-key/) (terme)
-   [Limite de débit (rate limit)](https://broadrouter.com/fr/glossary/rate-limit/) (terme)
-   [Fallback de modèle (model fallback)](https://broadrouter.com/fr/glossary/model-fallback/) (terme)
-   [Codes d’erreur de BroadNet Inference : quand réessayer ?](https://broadrouter.com/fr/guides/errors-and-retries/) (guide)
-   [Streamer des chat completions et gérer les connexions coupées](https://broadrouter.com/fr/guides/streaming-chat-completions/) (guide)
-   [Utiliser le SDK Python d’OpenAI avec BroadNet Inference](https://broadrouter.com/fr/guides/openai-python-sdk/) (guide)
-   [Agents de longue durée : timeouts, retries et checkpoints qui tiennent](https://broadrouter.com/fr/blog/long-running-agents-timeouts-retries/) (article)
-   [Gérer les erreurs 429 d’une API LLM : backoff, jitter et limiteurs](https://broadrouter.com/fr/blog/handle-llm-api-429-rate-limits/) (article)

Essayez-le sur votre vraie charge de travail. Les nouveaux comptes démarrent avec USD 5 de crédit pour Gemma et transcription. DeepSeek, GLM et Qwen3.8 nécessitent une recharge.

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

**Sources**

-   [README du SDK Python d’OpenAI, timeouts et retries (vérifié le 2026-11-15)](https://github.com/openai/openai-python)
-   [Documentation de HTTPX, timeouts (vérifié le 2026-11-15)](https://www.python-httpx.org/advanced/timeouts/)
-   [MDN, 504 Gateway Timeout (vérifié le 2026-11-15)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/504)
-   [MDN, 408 Request Timeout (vérifié le 2026-11-15)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/408)
-   [Référence de l’API BroadNet Inference, streaming et erreurs (vérifié le 2026-11-15) (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-glossary-request-timeout&utm_content=sources)
