---
title: "İstek zaman aşımı nedir? LLM API çağrılarında timeout"
description: "İstek zaman aşımı, istemcinin LLM API'sini vazgeçmeden önce ne kadar beklediğidir. Bağlantı ve okuma zaman aşımı, SDK varsayılanları, 408, 504 ve yeniden deneme."
url: https://broadrouter.com/tr/glossary/request-timeout/
lang: tr
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

İngilizceden yapay zekâ desteğiyle çevrilmiştir. [İngilizce aslını okuyun](https://broadrouter.com/glossary/request-timeout/) (güncelleme: 2026-11-15).

# İstek zaman aşımı (request timeout)

Güncellendi 2026-11-15

İstek zaman aşımı (request timeout), bir HTTP istemcisinin isteği bırakmadan önce sunucuyu bekleyeceği en uzun süredir. İstemciler bunu genellikle bağlantıyı açmak için bir bağlantı zaman aşımına ve veri beklemek için bir okuma zaman aşımına ayırır. LLM çağrıları cömert okuma zaman aşımları gerektirir, çünkü uzun yanıtlar zaman alır.

Diğer adları: zaman aşımı, okuma zaman aşımı, bağlantı zaman aşımı, istemci zaman aşımı, timeout, request timeout, read timeout, connect timeout, client timeout, HTTP timeout

Her ağ çağrısının beklemeyi bıraktığınız bir noktası olmalıdır. LLM çağrılarında bu noktayı seçmek zordur, çünkü yavaş bir yanıt ile ölü bir bağlantı bir süre aynı görünür.

## Nasıl çalışır

HTTP istemcileri beklemeyi aşamalara ayırır. Yaygın bir Python HTTP istemcisi olan HTTPX’te dört aşama vardır:

| Zaman aşımı | HTTPX’teki anlamı | Hata |
| --- | --- | --- |
| Connect (bağlantı) | Soket bağlantısı kurmak için en uzun süre | `ConnectTimeout` |
| Read (okuma) | Gelen bir veri parçası için en uzun bekleme | `ReadTimeout` |
| Write (yazma) | İstek gövdesinin bir parçasını göndermek için en uzun bekleme | `WriteTimeout` |
| Pool (havuz) | Havuzdan bağlantı almak için en uzun bekleme | `PoolTimeout` |

Düz HTTPX, varsayılan olarak beş saniyelik ağ hareketsizliğinden sonra zaman aşımına uğrar. OpenAI Python SDK’sı kendi varsayılanını belirler: “By default requests time out after 10 minutes” (çeviri: varsayılan olarak istekler 10 dakika sonra zaman aşımına uğrar), `APITimeoutError` fırlatır ve zaman aşımına uğrayan isteği iki kez yeniden dener. Ayrıca bağlantı hatalarını, 408, 409, 429 ve 5xx yanıtlarını da varsayılan olarak yeniden dener.

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

Sunucuların da zaman aşımları vardır. MDN, 504 Gateway Timeout’u “did not get a response in time from the upstream server” (çeviri: yukarı akıştaki sunucudan zamanında yanıt alamayan) bir ağ geçidi veya proxy olarak, 408 Request Timeout’u ise sunucunun “to shut down this unused connection” (çeviri: bu kullanılmayan bağlantıyı kapatmak) istemesi olarak tanımlar.

## Neden önemli

-   **Akıl yürütme modelleri geç başlar.** Düşünme, ilk görünür token’dan önce gerçekleşir. Akış kullanmayan bir çağrıdaki kısa bir okuma zaman aşımı, sağlıklı bir isteği kesebilir.
-   **Akışlar takılmayı yakalar.** [Akışta (streaming)](https://broadrouter.com/tr/glossary/streaming/) her parça okuma sayacını sıfırlar; bu yüzden uzun bir yanıtta bile takılma hızla fark edilir.
-   **Yeniden denemeler maliyeti ikiye katlayabilir.** Zaman aşımı, sunucunun durduğu anlamına gelmez. Hâlâ çalışan bir isteği yeniden denemek iki kez faturalandırılabilir. Üst sınırı olan [üstel geri çekilme (exponential backoff)](https://broadrouter.com/tr/glossary/exponential-backoff/) kullanın; API destekliyorsa bir [idempotency anahtarı](https://broadrouter.com/tr/glossary/idempotency-key/) ekleyin.

## BroadNet Inference’ta

BroadNet’in [API referansı](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-glossary-request-timeout&utm_content=body), bir akışın `data: [DONE]` gelene kadar okunmasını söyler. Bağlantı bundan önce biterse “treat the response as incomplete, record the X-Request-ID” (çeviri: yanıtı eksik kabul edin, X-Request-ID değerini kaydedin) ve uygulamanızın güvenle yeni bir istek yapıp yapamayacağına karar verin. 500, 502, 503 ve 504 için sınırlı üstel geri çekilmeyle yeniden denemeyi söyler; 429 ise bir hız, eşzamanlılık, token hızı veya harcama sınırına ulaşıldığı anlamına gelir. Destek için X-Request-ID değerini saklayın. [Hatalar ve yeniden denemeler rehberi](https://broadrouter.com/tr/guides/errors-and-retries/) ve [uzun süre çalışan ajanlar yazısı](https://broadrouter.com/tr/blog/long-running-agents-timeouts-retries/) çalışan ayarları gösterir.

## Sık yapılan hatalar

-   Varsayılanı olduğu gibi bırakıp askıda kalan bir çağrının neden bir işçiyi on dakika boyunca bloke ettiğine şaşırmak.
-   Üst sınır olmadan yeniden denemek; böylece kötü geçen bir dakika bir istek selline dönüşür.

## Sık sorulan sorular

### OpenAI Python SDK'sında varsayılan zaman aşımı nedir?

README'si "By default requests time out after 10 minutes" (çeviri: varsayılan olarak istekler 10 dakika sonra zaman aşımına uğrar) der; zaman aşımına uğrayan istekler varsayılan olarak kısa bir üstel geri çekilmeyle iki kez yeniden denenir.

### Her LLM çağrısı için tek bir zaman aşımı mı kullanmalıyım?

Hayır. Kısa bir sınıflandırma çağrısı ile uzun bir akıl yürütme yanıtı farklı sınırlar gerektirir. Akışta (streaming), parçalar arasındaki boşluğa uygulanan bir okuma zaman aşımı, takılmaları tek bir uzun toplam sınırdan daha iyi yakalar.

### BroadNet akışı erken durursa ne yapmalıyım?

BroadNet, data: \[DONE\] gelmeden biten bir akışı eksik kabul etmenizi, X-Request-ID değerini kaydetmenizi ve uygulamanızın güvenle yeni bir istek yapıp yapamayacağına karar vermenizi söyler.

## Ayrıca bakın

-   [Üstel geri çekilme (exponential backoff)](https://broadrouter.com/tr/glossary/exponential-backoff/) (terim)
-   [Akış (streaming)](https://broadrouter.com/tr/glossary/streaming/) (terim)
-   [Gecikme (latency)](https://broadrouter.com/tr/glossary/latency/) (terim)
-   [Idempotency anahtarı (idempotency key)](https://broadrouter.com/tr/glossary/idempotency-key/) (terim)
-   [Hız sınırı (rate limit)](https://broadrouter.com/tr/glossary/rate-limit/) (terim)
-   [Yedek modele geçiş (model fallback)](https://broadrouter.com/tr/glossary/model-fallback/) (terim)
-   [BroadNet Inference hata kodları ve ne zaman yeniden denenmeli](https://broadrouter.com/tr/guides/errors-and-retries/) (rehber)
-   [Chat completions akışı ve kopan bağlantıları ele alma](https://broadrouter.com/tr/guides/streaming-chat-completions/) (rehber)
-   [OpenAI Python SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-python-sdk/) (rehber)
-   [Uzun süren ajanlar: zaman aşımı, yeniden deneme ve kontrol noktası](https://broadrouter.com/tr/blog/long-running-agents-timeouts-retries/) (yazı)
-   [LLM API 429 hatası nasıl çözülür: geri çekilme, jitter, sınırlayıcılar](https://broadrouter.com/tr/blog/handle-llm-api-429-rate-limits/) (yazı)

Gerçek iş yükünüzle deneyin. Yeni hesaplar şunlar için US$5 kredi ile başlar: Gemma ve transkripsiyon. Bakiye yüklemesi gerekenler: DeepSeek, GLM ve Qwen3.8.

[Başlayın](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-glossary-request-timeout&utm_content=page-cta) ·

**Kaynaklar**

-   [OpenAI Python SDK README, zaman aşımları ve yeniden denemeler (2026-11-15 tarihinde kontrol edildi)](https://github.com/openai/openai-python)
-   [HTTPX belgeleri, zaman aşımları (2026-11-15 tarihinde kontrol edildi)](https://www.python-httpx.org/advanced/timeouts/)
-   [MDN, 504 Gateway Timeout (2026-11-15 tarihinde kontrol edildi)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/504)
-   [MDN, 408 Request Timeout (2026-11-15 tarihinde kontrol edildi)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/408)
-   [BroadNet Inference API referansı, akış ve hatalar (2026-11-15 tarihinde kontrol edildi) (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-glossary-request-timeout&utm_content=sources)
