---
title: "LLM API hata kodları 401, 402, 409, 429 ve yeniden deneme"
description: "BroadNet Inference API durum kodlarının anlamı; hangilerinin geri çekilmeyle yeniden deneneceği, hangilerinin önce düzeltileceği, desteğe ne gönderileceği."
url: https://broadrouter.com/tr/guides/errors-and-retries/
lang: tr
updated: 2026-11-14
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/guides/errors-and-retries/) (güncelleme: 2026-11-14).

# BroadNet Inference hata kodları ve ne zaman yeniden denenmeli

Güncellendi 2026-11-14

Gövdeyi ayrıştırmadan önce HTTP durum kodunu kontrol edin. 429 ve 5xx hatalarını sınırlı üstel geri çekilmeyle (exponential backoff) yeniden deneyin. 400, 403, 413 ve 422 hatalarını yeniden denemeden önce düzeltin. 401 için anahtarı ve bakiyeyi kontrol edin, 402 için hesaba bakiye yükleyin. Destek için X-Request-ID başlığını her zaman kaydedin.

API normal bir HTTP durum kodu ve makine tarafından okunabilir bir hata kodu döndürür. Bir sonraki adımı durum koduna göre seçin. Bu tablo BroadNet’in [API referansını](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-errors-and-retries&utm_content=body#errors) izler.

| Durum | Anlamı | Yapılacak |
| --- | --- | --- |
| 400 / 422 | Geçersiz istek veya alan | Önce isteği düzeltin |
| 401 | Eksik, geçersiz veya süresi dolmuş anahtar, engellenmiş kullandıkça öde bütçesi ya da tükenmiş kullanım hakkı | Anahtar durumunu ve hesap bakiyesini kontrol edin |
| 402 `insufficient_balance` | Hesap bir satın almayı karşılayamıyor; gövde bakiyeyi ve fiyatı içerir | Bakiye yükleyin, sonra tekrar deneyin |
| 403 | Model, rota veya IP politikası tarafından reddedildi | Uyumsuzluğu giderin, örneğin [bir IP izin listesi](https://broadrouter.com/tr/guides/api-keys-ip-allow-lists/) |
| 409 | Hesap durumuyla çakışma: `mint_in_progress`, `key_limit_reached`, `credential_limit_reached`, `key_pending` | Yalnızca `mint_in_progress` durumunu, aynı `request_id` ile yeniden deneyin |
| 413 | İstek çok büyük; transkripsiyon dosyaları 26.214.400 baytla sınırlıdır | İsteği küçültün |
| 429 | Hız, eşzamanlılık, token hızı veya harcama sınırına ulaşıldı | Yanıt ayrıntılarını okuyun, bekleyin ve yeniden deneyin |
| 500 / 502 / 503 / 504 | Sunucu tarafında işlem | Sınırlı üstel geri çekilmeyle yeniden deneyin; saatlik anahtar satın alımlarında aynı `request_id` değerini kullanın |

BroadNet’in belgeleri, bir JSON gövdesini ayrıştırmadan önce HTTP durum kodunu kontrol etmenizi, ardından varsa makine tarafından okunabilir `error` kodunu okumanızı söyler.

## Hangi sınırlar 429’a yol açar?

Kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda 4 isteğe izin verir. BroadNet’in belgelerine göre saatlik anahtar dakikada 120 istek, tek akış ve dakikada 300,000 token hakkı tanır. [Sınırsız planda](https://broadrouter.com/tr/guides/unlimited-llm-api-sessions/) her oturum aynı anda tek istek çalıştırır. Bu sınırların OpenAI, Anthropic, Groq ve DeepSeek ile karşılaştırması için [sağlayıcılara göre LLM API hız sınırları](https://broadrouter.com/tr/blog/llm-api-rate-limits-by-provider/) yazısını okuyun.

## OpenAI SDK ile nasıl yeniden denenir?

[GitHub’daki README dosyasına](https://github.com/openai/openai-python#retries) göre OpenAI Python SDK; bağlantı hatalarını, 408, 409, 429 ve 5xx yanıtlarını varsayılan olarak kısa üstel geri çekilmeyle zaten iki kez yeniden dener. Varsayılan zaman aşımı 10 dakikadır. İkisini de açıkça ayarlayın (koddaki yorumlar: `max_retries=0` otomatik yeniden denemeleri kapatır; `timeout` saniye cinsindendir ve uzun akıl yürütme yanıtları için artırılmalıdır):

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_retries=4,   # 0 turns automatic retries off
    timeout=120,     # seconds; raise it for long reasoning answers
)
```

## Kendi geri çekilme mantığımı nasıl yazarım?

API’yi SDK olmadan çağırıyorsanız hem deneme sayısını hem de bekleme süresini sınırlayın. Aşağıdaki fonksiyon, durum kodu yeniden denenecekler arasında değilse yanıtı hemen döndürür: bu ya başarıdır ya da yeniden denemek yerine düzeltilmesi gereken bir hatadır.

```python
import random, time, requests

RETRY = {429, 500, 502, 503, 504}

def post_with_backoff(url, headers, body, tries=5):
    for attempt in range(tries):
        r = requests.post(url, headers=headers, json=body, timeout=120)
        if r.status_code not in RETRY:
            return r                      # success, or an error to fix rather than retry
        time.sleep(min(30, 2 ** attempt) + random.random())
    return r
```

400, 403, 413 veya 422 hatalarını hiçbir şeyi değiştirmeden asla yeniden denemeyin: aynı istek aynı şekilde başarısız olur. Bir sohbet isteğinin her yeniden denemesi yeni bir çıkarımdır ve kullandıkça öde modelinde yeniden faturalandırılır. Genel kalıp için bkz. [üstel geri çekilme](https://broadrouter.com/tr/glossary/exponential-backoff/).

## Saatlik anahtar satın alımını güvenle yeniden denemek

`POST /portal/keys/hourly` bir `request_id` alır. Zaman aşımı, kopan bağlantı, 409 `mint_in_progress` veya 5xx sonrasında **aynı** `request_id` ile yeniden deneyin. Yeniden kullanılan bir `request_id` asla ikinci bir anahtar oluşturmaz veya ikinci kez ücret almaz; tekrar edilen istek `already_issued: true` ve anahtar takma adını döndürür. İlk sonucu öğrenmeden asla yeni bir kimlik üretmeyin. Ayrıntılar: [idempotency anahtarları](https://broadrouter.com/tr/glossary/idempotency-key/).

## Sorun giderme

-   **Bakiye yükledikten hemen sonra 401.** BroadNet’in hesap sayfası en son kaydedilen kullanım hakkını gösterir ve bir bakiye değişikliğini uygulanırken “güncelleniyor” olarak işaretler. Sayfayı yenileyin ve işlem bittiğinde tekrar deneyin.
-   **Dakikada yalnızca birkaç istekle 429.** Büyük olasılıkla 4 isteklik eşzamanlılık sınırına takılıyorsunuz; örneğin paralel çalışan uzun akışlarla. Küçük bir worker havuzu kullanın.
-   **Bir modelde 403, diğerinde değil.** Anahtarın politikası o modeli veya rotayı kapsamıyor. Örneğin plan anahtarları `broadnet/deepseek-v4.1-flash` içindir, saatlik anahtar ise yalnızca `broadnet/gemma-4-26b-a4b` modelini kapsar.
-   **SDK yeniden denedi ve iki kez ücret ödediniz.** Yeniden denenen bir sohbet isteği yeni bir çıkarımdır. Yinelenen bir yanıtın başarısız bir yanıttan daha pahalıya geldiği yerlerde `max_retries=0` ayarlayın.

## Desteğe ne gönderilmeli

`X-Request-ID` başlığının değerini, UTC zaman damgasını, rotayı, HTTP durum kodunu ve anahtar takma adınızı ekleyin. Anahtarın kendisini asla göndermeyin. Başlığın nasıl okunacağı [OpenAI Python SDK rehberinde](https://broadrouter.com/tr/guides/openai-python-sdk/) gösteriliyor.

## Bu rehberdeki terimler

[Eşzamanlılık (concurrency)](https://broadrouter.com/tr/glossary/concurrency/)

Eşzamanlılık (concurrency), bir istemcinin aynı anda işlemde olan istek sayısıdır. LLM API'leri bunu genellikle dakikadaki istek sayısından ayrı olarak anahtar veya plan başına sınırlar, çünkü açık her istek yanıtı bitene kadar GPU kapasitesi tutar.

[Kullandıkça öde (pay-as-you-go)](https://broadrouter.com/tr/glossary/pay-as-you-go/)

Kullandıkça öde, abonelik veya asgari taahhüt olmadan yalnızca kullandığınız kadar ödediğiniz, token, istek veya ses dakikası gibi birimler üzerinden ölçülen bir fiyatlandırma modelidir. LLM API'lerinin çoğu bu şekilde, ön ödemeli bir bakiyeden veya dönemsel faturayla ücretlendirir.

[Hız sınırı (rate limit)](https://broadrouter.com/tr/glossary/rate-limit/)

Hız sınırı (rate limit), bir API'nin bir istemcinin belirli bir zaman aralığındaki kullanımına koyduğu üst sınırdır; örneğin dakika başına istek veya dakika başına token. Sınırı aşan istekler, kullanım tekrar sınırın altına inene kadar genellikle HTTP 429 Too Many Requests ile reddedilir.

[İstek zaman aşımı (request timeout)](https://broadrouter.com/tr/glossary/request-timeout/)

İ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.

[Token](https://broadrouter.com/tr/glossary/token/)

Token, bir dil modelinin okuduğu ve yazdığı metin birimidir: modelin tokenizer'ının ürettiği bir kelime, kelime parçası, noktalama işareti veya bayt dizisi. LLM API'leri kullanımı token cinsinden sayar, sınırlar ve genellikle faturalandırır.

[Akış (streaming)](https://broadrouter.com/tr/glossary/streaming/)

Akış (streaming), bir dil modeli yanıtını sonda tek parça halinde değil, hâlâ üretilirken küçük parçalar halinde döndürme yöntemidir. OpenAI uyumlu API'ler, istekte stream değeri true olduğunda server-sent events (SSE) üzerinden akış yapar.

[IP izin listesi (IP allow list)](https://broadrouter.com/tr/glossary/ip-allow-list/)

IP izin listesi, yalnızca listelenen IP adreslerinden veya CIDR aralıklarından gelen istekleri kabul edip diğer tümünü reddeden bir güvenlik denetimidir. Bir API'de sızdırılmış bir anahtarın vereceği zararı sınırlar, çünkü anahtar listede olmayan ağlardan çalışmaz.

[Üstel geri çekilme (exponential backoff)](https://broadrouter.com/tr/glossary/exponential-backoff/)

Üstel geri çekilme (exponential backoff), istemcinin her başarısız denemeden sonra tekrar denemeden önce daha uzun beklediği, genellikle gecikmeyi bir üst sınıra kadar ikiye katladığı bir yeniden deneme stratejisidir. Her beklemeye rastgele jitter eklemek, birçok istemcinin yeniden denemelerini yayar; böylece sunucuya aynı anda yüklenmezler.

## Sık sorulan sorular

### Bir LLM API'sinden gelen 429 hatasını yeniden denemeli miyim?

Evet, sınırlı üstel geri çekilmeyle. BroadNet Inference'ta 429, bir hız, eşzamanlılık, token hızı veya harcama sınırına ulaşıldığı anlamına gelir. Sık tekrarlanıyorsa paralelliği azaltın; neden bir harcama sınırıysa yeniden denemeyi bırakın.

### Anahtarım doğru olduğu hâlde neden 401 alıyorum?

BroadNet'te 401 yalnızca yanlış veya süresi dolmuş bir anahtarı değil, tükenmiş bir kullandıkça öde kullanım hakkını veya engellenmiş bir bütçeyi de kapsar. Hesap sayfasında bakiyeyi ve anahtarın durumunu kontrol edin.

### Burada 401 ile 403 arasındaki fark nedir?

401 anahtarla veya hesabın kullanım hakkıyla ilgilidir. 403 ise anahtarın çalıştığını ama isteğin model, rota veya IP politikası tarafından reddedildiğini gösterir; örneğin izin listesinde olmayan bir adresten yapılan çağrı.

### OpenAI SDK hataları otomatik olarak yeniden dener mi?

Evet. OpenAI Python SDK; bağlantı hatalarını, 408, 409, 429 ve 5xx yanıtlarını varsayılan olarak kısa üstel geri çekilmeyle iki kez yeniden dener. Sayıyı değiştirmek için max\_retries ayarlayın, yeniden denemeleri kapatmak için 0 yapın.

## İlgili rehberler

-   [Chat completions akışı ve kopan bağlantıları ele alma](https://broadrouter.com/tr/guides/streaming-chat-completions/)
-   [API anahtarlarını IP izin listeleriyle sunucularınıza kilitleyin](https://broadrouter.com/tr/guides/api-keys-ip-allow-lists/)
-   [OpenAI Python SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-python-sdk/)

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-guides-errors-and-retries&utm_content=page-cta) ·

**Kaynaklar**

-   [BroadNet Inference API referansı, hatalar ve yeniden denemeler (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-errors-and-retries&utm_content=sources#errors)
-   [BroadNet Inference API referansı, sınırlar (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-errors-and-retries&utm_content=sources#limits)
-   [OpenAI Python SDK README, yeniden denemeler ve zaman aşımları (2026-11-14 tarihinde kontrol edildi)](https://github.com/openai/openai-python#retries)
