---
title: "O que é timeout de requisição? Timeouts em APIs de LLM"
description: "Timeout é quanto o cliente espera uma API de LLM antes de desistir. Timeouts de conexão e leitura, padrões dos SDKs, 408 e 504 e como repetir com segurança."
url: https://broadrouter.com/pt/glossary/request-timeout/
lang: pt-BR
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/glossary/request-timeout/) (atualizado em 2026-11-15).

# Timeout de requisição (request timeout)

Atualizado em 2026-11-15

Timeout de requisição é o tempo máximo que um cliente HTTP espera por um servidor antes de abandonar a requisição. Os clientes costumam dividi-lo em timeout de conexão, para abrir a conexão, e timeout de leitura, para esperar os dados. Chamadas a LLMs precisam de timeouts de leitura generosos, porque respostas longas levam tempo.

Também chamado de: timeout, timeout de requisição, timeout de leitura, timeout de conexão, tempo limite da requisição, request timeout, read timeout, connect timeout, client timeout, HTTP timeout

Toda chamada de rede precisa de um ponto em que você para de esperar. Em chamadas a LLMs, esse ponto é difícil de escolher, porque por um tempo uma resposta lenta e uma conexão morta parecem iguais.

## Como funciona

Clientes HTTP dividem a espera em fases. O HTTPX, um cliente HTTP comum em Python, tem quatro:

| Timeout | Significado no HTTPX | Erro |
| --- | --- | --- |
| Connect | Tempo máximo para estabelecer uma conexão de socket | `ConnectTimeout` |
| Read | Espera máxima por um chunk de dados recebidos | `ReadTimeout` |
| Write | Espera máxima para enviar um chunk do corpo da requisição | `WriteTimeout` |
| Pool | Espera máxima por uma conexão do pool | `PoolTimeout` |

O HTTPX puro expira por padrão após cinco segundos de inatividade de rede. O SDK Python da OpenAI define seu próprio padrão: “By default requests time out after 10 minutes” (tradução: por padrão, as requisições expiram depois de 10 minutos), lança `APITimeoutError` e repete duas vezes uma requisição que expirou. Por padrão, ele também repete erros de conexão e respostas 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)
```

Servidores também têm timeouts. A MDN define o 504 Gateway Timeout como um gateway ou proxy que “did not get a response in time from the upstream server” (não recebeu resposta a tempo do servidor upstream), e o 408 Request Timeout como o servidor querendo “to shut down this unused connection” (encerrar esta conexão não utilizada).

## Por que isso importa

-   **Modelos de raciocínio demoram para começar.** O raciocínio acontece antes do primeiro token visível. Um timeout de leitura curto em uma chamada sem streaming pode cortar uma requisição saudável.
-   **Streams detectam travamentos.** Com [streaming](https://broadrouter.com/pt/glossary/streaming/), cada chunk reinicia o cronômetro de leitura, então um travamento aparece rápido mesmo em uma resposta longa.
-   **Retries podem dobrar o custo.** Um timeout não significa que o servidor parou. Repetir uma requisição que ainda está rodando pode gerar cobrança dupla. Use [backoff exponencial](https://broadrouter.com/pt/glossary/exponential-backoff/) com teto e uma [idempotency key](https://broadrouter.com/pt/glossary/idempotency-key/) quando a API suportar.

## Na BroadNet Inference

A [referência da API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-glossary-request-timeout&utm_content=body) da BroadNet diz para ler um stream até `data: [DONE]`. Se a conexão terminar antes disso, “treat the response as incomplete, record the X-Request-ID” (tradução: trate a resposta como incompleta, registre o X-Request-ID) e decida se a sua aplicação pode fazer uma nova requisição com segurança. Para 500, 502, 503 e 504, ela diz para repetir com backoff exponencial limitado; 429 significa que um limite de taxa, de concorrência, de tokens por minuto ou de gasto foi atingido. Guarde o X-Request-ID para o suporte. O [guia de erros e retries](https://broadrouter.com/pt/guides/errors-and-retries/) e o [post sobre agentes de longa duração](https://broadrouter.com/pt/blog/long-running-agents-timeouts-retries/) mostram configurações que funcionam.

## Erros comuns

-   Deixar o padrão e não entender por que uma chamada travada bloqueia um worker por dez minutos.
-   Repetir sem teto, fazendo um minuto ruim virar uma enxurrada de requisições.

## Perguntas frequentes

### Qual é o timeout padrão do SDK Python da OpenAI?

O README diz "By default requests time out after 10 minutes" (por padrão, as requisições expiram depois de 10 minutos), e requisições que expiram são repetidas duas vezes por padrão, com um backoff exponencial curto.

### Devo usar um único timeout para todas as chamadas a LLM?

Não. Uma chamada curta de classificação e uma resposta longa de raciocínio precisam de limites diferentes. Com streaming, um timeout de leitura no intervalo entre chunks detecta travamentos melhor do que um único limite total longo.

### O que fazer quando um stream da BroadNet para antes da hora?

A BroadNet diz para tratar um stream que termina antes de data: \[DONE\] como incompleto, registrar o X-Request-ID e decidir se a sua aplicação pode fazer uma nova requisição com segurança.

## Veja também

-   [Backoff exponencial (exponential backoff)](https://broadrouter.com/pt/glossary/exponential-backoff/) (termo)
-   [Streaming](https://broadrouter.com/pt/glossary/streaming/) (termo)
-   [Latência (latency)](https://broadrouter.com/pt/glossary/latency/) (termo)
-   [Chave de idempotência (idempotency key)](https://broadrouter.com/pt/glossary/idempotency-key/) (termo)
-   [Rate limit (limite de taxa)](https://broadrouter.com/pt/glossary/rate-limit/) (termo)
-   [Fallback de modelo (model fallback)](https://broadrouter.com/pt/glossary/model-fallback/) (termo)
-   [Códigos de erro da BroadNet Inference e quando tentar de novo](https://broadrouter.com/pt/guides/errors-and-retries/) (guia)
-   [Streaming de chat completions e conexões que caem](https://broadrouter.com/pt/guides/streaming-chat-completions/) (guia)
-   [Como usar o SDK Python da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-python-sdk/) (guia)
-   [Agentes de longa duração: timeouts, retentativas e checkpoints](https://broadrouter.com/pt/blog/long-running-agents-timeouts-retries/) (artigo)
-   [Erro 429 em API de LLM: backoff, jitter e limitadores](https://broadrouter.com/pt/blog/handle-llm-api-429-rate-limits/) (artigo)

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

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

**Fontes**

-   [README do SDK Python da OpenAI, timeouts e retries (conferido em 2026-11-15)](https://github.com/openai/openai-python)
-   [Documentação do HTTPX, timeouts (conferido em 2026-11-15)](https://www.python-httpx.org/advanced/timeouts/)
-   [MDN, 504 Gateway Timeout (conferido em 2026-11-15)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/504)
-   [MDN, 408 Request Timeout (conferido em 2026-11-15)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/408)
-   [Referência da API da BroadNet Inference, streaming e erros (conferido em 2026-11-15) (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-glossary-request-timeout&utm_content=sources)
