---
title: "Cos’è il timeout di una richiesta? Timeout per le API LLM"
description: "Il timeout è quanto un client aspetta un’API LLM prima di rinunciare. Timeout di connessione e lettura, default degli SDK, 408 e 504, e retry sicuri."
url: https://broadrouter.com/it/glossary/request-timeout/
lang: it
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/glossary/request-timeout/) (aggiornato il 2026-11-15).

# Timeout della richiesta (request timeout)

Aggiornato 2026-11-15

Il timeout di una richiesta è il tempo massimo che un client HTTP aspetta un server prima di abbandonare la richiesta. I client di solito lo dividono in un timeout di connessione, per aprire la connessione, e un timeout di lettura, per l’attesa dei dati. Le chiamate LLM richiedono timeout di lettura generosi perché le risposte lunghe richiedono tempo.

Detto anche: timeout, timeout della richiesta, timeout di lettura, timeout di connessione, timeout HTTP, request timeout, read timeout, connect timeout, client timeout, HTTP timeout

Ogni chiamata di rete ha bisogno di un punto in cui smetti di aspettare. Per le chiamate LLM quel punto è difficile da scegliere, perché per un po’ una risposta lenta e una connessione morta sembrano uguali.

## Come funziona

I client HTTP dividono l’attesa in fasi. HTTPX, un client HTTP Python molto diffuso, ne ha quattro:

| Timeout | Significato in HTTPX | Errore |
| --- | --- | --- |
| Connect | Tempo massimo per stabilire una connessione socket | `ConnectTimeout` |
| Read | Attesa massima per un chunk di dati in arrivo | `ReadTimeout` |
| Write | Attesa massima per inviare un chunk del body della richiesta | `WriteTimeout` |
| Pool | Attesa massima per ottenere una connessione dal pool | `PoolTimeout` |

HTTPX da solo va in timeout dopo cinque secondi di inattività di rete. L’SDK Python di OpenAI imposta un proprio default: “By default requests time out after 10 minutes” (traduzione: per impostazione predefinita le richieste vanno in timeout dopo 10 minuti), solleva `APITimeoutError` e ritenta due volte una richiesta andata in timeout. Di default ritenta anche errori di connessione e risposte 408, 409, 429 e 5xx.

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

Anche i server hanno dei timeout. MDN definisce il 504 Gateway Timeout come un gateway o proxy che “did not get a response in time from the upstream server” (non ha ricevuto in tempo una risposta dal server a monte), e il 408 Request Timeout come il server che vuole “to shut down this unused connection” (chiudere questa connessione inutilizzata).

## Perché è importante

-   **I modelli di ragionamento partono lenti.** Il ragionamento avviene prima del primo token visibile. Un timeout di lettura breve su una chiamata senza streaming può interrompere una richiesta che sta andando bene.
-   **Gli stream rivelano i blocchi.** Con lo [streaming](https://broadrouter.com/it/glossary/streaming/), ogni chunk azzera il timer di lettura, quindi un blocco emerge subito anche in una risposta lunga.
-   **I retry possono raddoppiare il costo.** Un timeout non significa che il server si sia fermato. Ritentare una richiesta ancora in esecuzione può farti pagare due volte. Usa un [backoff esponenziale](https://broadrouter.com/it/glossary/exponential-backoff/) con un tetto, e una [idempotency key](https://broadrouter.com/it/glossary/idempotency-key/) dove l’API la supporta.

## Su BroadNet Inference

Il [riferimento API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-request-timeout&utm_content=body) di BroadNet dice di leggere uno stream fino a `data: [DONE]`. Se la connessione si chiude prima, “treat the response as incomplete, record the X-Request-ID” (traduzione: considera la risposta incompleta, registra l’X-Request-ID) e decidi se la tua applicazione può fare una nuova richiesta in sicurezza. Per 500, 502, 503 e 504 indica di ritentare con un backoff esponenziale limitato; un 429 significa che è stato raggiunto un limite di frequenza, di concorrenza, di token al minuto o di spesa. Conserva l’X-Request-ID per l’assistenza. La [guida a errori e retry](https://broadrouter.com/it/guides/errors-and-retries/) e l’[articolo sugli agenti di lunga durata](https://broadrouter.com/it/blog/long-running-agents-timeouts-retries/) mostrano impostazioni funzionanti.

## Errori comuni

-   Lasciare il default e chiedersi perché una chiamata bloccata tenga fermo un worker per dieci minuti.
-   Ritentare senza un tetto, così un minuto storto diventa una valanga di richieste.

## Domande frequenti

### Qual è il timeout predefinito dell’SDK Python di OpenAI?

Il suo README dice "By default requests time out after 10 minutes" (per impostazione predefinita le richieste vanno in timeout dopo 10 minuti), e le richieste in timeout vengono ritentate due volte di default con un breve backoff esponenziale.

### Devo usare un solo timeout per tutte le chiamate LLM?

No. Una breve chiamata di classificazione e una lunga risposta di ragionamento hanno bisogno di limiti diversi. Con lo streaming, un timeout di lettura sull’intervallo tra i chunk intercetta i blocchi meglio di un unico limite totale lungo.

### Cosa devo fare quando uno stream di BroadNet si interrompe prima del tempo?

BroadNet dice di considerare incompleto uno stream che termina prima di data: \[DONE\], di registrare l’X-Request-ID e di decidere se la tua applicazione può fare una nuova richiesta in sicurezza.

## Vedi anche

-   [Backoff esponenziale (exponential backoff)](https://broadrouter.com/it/glossary/exponential-backoff/) (termine)
-   [Streaming](https://broadrouter.com/it/glossary/streaming/) (termine)
-   [Latenza (latency)](https://broadrouter.com/it/glossary/latency/) (termine)
-   [Chiave di idempotenza (idempotency key)](https://broadrouter.com/it/glossary/idempotency-key/) (termine)
-   [Rate limit (limite di frequenza)](https://broadrouter.com/it/glossary/rate-limit/) (termine)
-   [Fallback del modello (model fallback)](https://broadrouter.com/it/glossary/model-fallback/) (termine)
-   [Codici di errore di BroadNet Inference e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/) (guida)
-   [Streaming delle chat completions e connessioni interrotte](https://broadrouter.com/it/guides/streaming-chat-completions/) (guida)
-   [Usare l’SDK Python di OpenAI con BroadNet Inference](https://broadrouter.com/it/guides/openai-python-sdk/) (guida)
-   [Agenti di lunga durata: timeout, retry e checkpoint che reggono](https://broadrouter.com/it/blog/long-running-agents-timeouts-retries/) (articolo)
-   [Errore 429 nelle API LLM: backoff, jitter e limitatori](https://broadrouter.com/it/blog/handle-llm-api-429-rate-limits/) (articolo)

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

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

**Fonti**

-   [README dell’SDK Python di OpenAI, timeout e retry (verificato il 2026-11-15)](https://github.com/openai/openai-python)
-   [Documentazione di HTTPX, timeout (verificato il 2026-11-15)](https://www.python-httpx.org/advanced/timeouts/)
-   [MDN, 504 Gateway Timeout (verificato il 2026-11-15)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/504)
-   [MDN, 408 Request Timeout (verificato il 2026-11-15)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/408)
-   [Riferimento API di BroadNet Inference, streaming ed errori (verificato il 2026-11-15) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-request-timeout&utm_content=sources)
