---
title: "Open WebUI özel OpenAI uyumlu uç nokta kurulumu | BroadRouter"
description: "BroadNet Inference'ı Open WebUI'a OpenAI uyumlu bağlantı olarak ekleyin, model kimliklerini izin listesine ekleyin; doğrulama, boş yanıt ve 429 sorunlarını çözün."
url: https://broadrouter.com/tr/guides/open-webui-openai-api/
lang: tr
updated: 2026-11-16
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/open-webui-openai-api/) (güncelleme: 2026-11-16).

# Open WebUI'ı BroadNet Inference'a bağlayın

Güncellendi 2026-11-16

Open WebUI'da yönetici bölümündeki Settings > Connections sayfasına gidin, Manage OpenAI API Connections altında Add Connection'a tıklayın, URL'yi https://inference.broadnet.ai/v1, API Key'i BroadNet anahtarınız yapın. Ardından broadnet/glm-5.3 gibi model kimliklerini Model IDs izin listesine ekleyip kaydedin.

Open WebUI, kendi sunucunuzda barındırdığınız bir sohbet arayüzüdür. OpenAI chat completions protokolünü uygulayan her sağlayıcıya bağlanır; BroadNet Inference de bunu uygular. Adımlar [Open WebUI’ın OpenAI uyumlu sağlayıcılar rehberini](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible) izler.

## Kurulum

1.  **Bir BroadNet anahtarı alın.** Birkaç kişinin kullandığı bir sohbet arayüzü için kullandıkça öde anahtarı doğru seçimdir. [API anahtarları ve IP izin listeleri](https://broadrouter.com/tr/guides/api-keys-ip-allow-lists/) rehberine bakın.
    
2.  **Bağlantılar sayfasını açın.** Yönetici bölümünde **Settings > Connections** sayfasına gidin ve **Manage OpenAI API Connections** bölümünü bulun.
    
3.  **Add Connection’a tıklayın** ve şunları doldurun:
    
    | Alan | Değer |
    | --- | --- |
    | URL | `https://inference.broadnet.ai/v1` (sonda eğik çizgi olmadan) |
    | API Key | BroadNet anahtarınız |
    | Model IDs | aşağıdaki her kimliği **+** simgesiyle tek tek ekleyin |
    
4.  **Model kimliklerini elle ekleyin.** `broadnet/glm-5.3` yazın, **+** simgesine tıklayın ve istediğiniz diğer modeller için tekrarlayın. BroadNet’in belgeleri `GET /v1/models` uç noktasını izleme araçları için herkese açık katalog meta verisi olarak tanımlar; model seçiciyi doldurmak için buna güvenmeyin.
    
5.  **Save’e tıklayın.** Open WebUI’ın belgeleri, kaydetmenin bağlantıyı test etmediğini belirtir.
    
6.  **Bir sohbet başlatın** ve modeli model seçiciden seçin.
    

### Ortam değişkenleriyle

Open WebUI’ı Docker’da çalıştırıyorsanız bağlantıyı başlangıçta ayarlayabilirsiniz:

```bash
OPENAI_API_BASE_URL=https://inference.broadnet.ai/v1
OPENAI_API_KEY=your-broadnet-key
```

BroadNet’i mevcut bir OpenAI bağlantısının yanına eklemek için noktalı virgülle ayrılan çoğul biçimleri kullanın: `OPENAI_API_BASE_URLS` ve `OPENAI_API_KEYS`. `OPENAI_API_CONFIGS`, `model_ids` gibi bağlantıya özel seçenekleri, bağlantının o listedeki sırasına (indeksine) göre ayarlar:

```bash
OPENAI_API_CONFIGS='{"0": {"enable": true, "model_ids": ["broadnet/glm-5.3", "broadnet/qwen3.8-27b"]}}'
```

Open WebUI’ın [ortam değişkeni referansı](https://docs.openwebui.com/reference/env-configuration) bunları ConfigVar ayarları olarak işaretler. İlk açılışta okunur ve veritabanına kaydedilirler. Sonrasında yönetim paneli geçerli olur. Bağlantıyı yönetici bölümündeki **Settings > Connections** sayfasında düzenleyin ya da ortamın her açılışta uygulanmasını istiyorsanız `ENABLE_PERSISTENT_CONFIG=False` ayarlayın.

## Hangi modeli seçmeli

| Kullanım | Model | Bağlam |
| --- | --- | --- |
| Genel sohbet, araçlar, JSON | `broadnet/glm-5.3` | 1.048.576 |
| Görsel soruları, Arapça | `broadnet/qwen3.8-27b` | 262.144 |
| Uzun belgeler, görseller | `broadnet/deepseek-v4.1-flash` | 1.048.576 |
| Düşük maliyet, ücretsiz kredi | `broadnet/gemma-4-26b-a4b` | 32.768 |

BroadNet, Qwen3.8 27B’yi Körfez ve Mısır lehçeleri dahil Arapçada test etti; [Arapça için LLM seçimi](https://broadrouter.com/tr/blog/choosing-an-llm-for-arabic/) yazısına bakın. $5 başlangıç kredisiyle çalışan tek sohbet modeli Gemma 4 VL 26B’dir; kredi iki Transcribe modelini de kapsar. Her birinin fiyatı [fiyatlandırma sayfasında](https://broadrouter.com/tr/pricing/).

Open WebUI `temperature` ve `max_tokens` gibi standart parametreleri iletir ve model ile sunucu `tools` desteklediğinde araç kullanımını destekler. BroadNet araçları GLM 5.3 ve Qwen3.8 27B için listeler.

## Sorun giderme

-   **Verify Connection 400, 401 veya 403 ile başarısız.** Open WebUI’ın doğrulama düğmesi `/models` adresini çağırır. Belgelerine göre chat completions yine de çalışabilir. Kimlikleri izin listesine ekleyip bir sohbeti test edin. Sohbet de 401 döndürüyorsa anahtar yanlış, süresi dolmuş ya da kullandıkça öde kullanım hakkı tükenmiş demektir.
-   **Model listede ama ilk mesaj başarısız.** Kimliğin `broadnet/` önekiyle birlikte BroadNet’tekiyle birebir aynı olduğunu kontrol edin. GLM 5.3, Qwen3.8 27B ve DeepSeek V4.1 Flash bakiye yüklemesi gerektirir.
-   **Boş yanıtlar.** Akıl yürütme modelleri (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) çıktı token’larını önce akıl yürütmeye harcar. Modelin **Advanced Params** bölümünde **max\_tokens** ayarladıysanız değeri artırın ya da temizleyin. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
-   **Birkaç kişi sohbet ederken 429.** Kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda 4 isteğe izin verir. Open WebUI aynı anahtarla sohbet başlıkları gibi arka plan çağrıları da yapar. [Hatalar ve yeniden denemeler](https://broadrouter.com/tr/guides/errors-and-retries/) rehberine bakın.
-   **Değiştirilen ortam değişkenleri işe yaramıyor.** İlk açılış eski değerleri kaydetti. Bağlantıyı yönetim panelinde düzenleyin ya da yukarıdaki ortam değişkenleri bölümüne bakın.
-   **Plan anahtarı kullanmak.** Bir [sınırsız plan oturumu](https://broadrouter.com/tr/guides/unlimited-llm-api-sessions/) aynı anda tek istek çalıştırır ve anahtarlar paylaşılamaz. Tek kişinin kendi kurulumuna uygundur; diğer kullanıcıların istekleri sıraya girer.

## Bu rehberdeki terimler

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

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

[Chat Completions API](https://broadrouter.com/tr/glossary/chat-completions-api/)

Chat Completions API, OpenAI'nin bir model adı ile rollerle etiketlenmiş mesaj listesini alıp modelin sonraki mesajını döndüren HTTP uç noktasıdır: POST /v1/chat/completions. İstek ve yanıt yapısı, OpenAI uyumlu sağlayıcıların ve SDK'ların yeniden kullandığı ortak format hâline geldi.

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

[API anahtarı (API key)](https://broadrouter.com/tr/glossary/api-key/)

API anahtarı, bir API'yi çağıran istemciyi tanımlayan ve yetkilendiren gizli bir dizedir. LLM API'leri genellikle anahtarı Authorization: Bearer başlığında bekler; anahtarı elinde tutan herkes, sahibi olan hesaba faturalandırılan istekler yapabilir.

[Girdi ve çıktı token'ları](https://broadrouter.com/tr/glossary/input-and-output-tokens/)

Girdi token'ları, bir dil modelinin istekte okuduğu token'lardır: sistem istemi, konuşma geçmişi, araç tanımları ve görseller dahil. Çıktı token'ları ise modelin yanıt olarak ürettikleridir, akıl yürütme dahil. LLM API'leri bunları genellikle ayrı fiyatlandırır ve çıktı genellikle daha pahalıdır.

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

[max\_tokens](https://broadrouter.com/tr/glossary/max-tokens/)

max\_tokens, bir modelin tek bir yanıtta üretebileceği en yüksek token sayısını belirleyen bir LLM API parametresidir. Üretim bu sınıra ulaştığında durur ve yanıt kesilmiş olarak işaretlenir; örneğin finish\_reason değeri "length" olur.

## Sık sorulan sorular

### Verify Connection başarısız oluyor ama sohbet çalışıyor; neden?

Open WebUI'ın doğrulama düğmesi sağlayıcının /models uç noktasını çağırır. Belgelerine göre başarısız bir kontrol, sohbetin bozuk olduğu anlamına gelmez. BroadNet model kimliklerini Model IDs izin listesine elle ekleyin.

### Bağlantıyı ortam değişkenleriyle ayarlayabilir miyim?

Evet. OPENAI\_API\_BASE\_URL değişkenini https://inference.broadnet.ai/v1, OPENAI\_API\_KEY değişkenini de BroadNet anahtarınız yapın. Open WebUI bunları ilk açılışta kaydeder; ENABLE\_PERSISTENT\_CONFIG False değilse değişkenlerde sonradan yapılan değişiklikler yok sayılır.

### Yeni OPENAI\_API\_BASE\_URL değerim neden etkili olmadı?

Open WebUI bunu bir ConfigVar olarak ele alır. İlk açılıştan sonra veritabanına kaydedilen değeri kullanır. URL'yi yönetici bölümündeki Settings > Connections sayfasında değiştirin ya da ortamın her açılışta okunması için ENABLE\_PERSISTENT\_CONFIG=False ayarlayın.

### Tüm ekip Open WebUI'da tek bir sınırsız plan anahtarını paylaşabilir mi?

Hayır. BroadNet'in planları anahtar paylaşımına izin vermez ve bir plan oturumu aynı anda tek istek çalıştırır. Paylaşılan bir Open WebUI için kullandıkça öde anahtarı kullanın.

## İlgili rehberler

-   [BroadNet Inference'ı LibreChat'e özel uç nokta olarak ekleyin](https://broadrouter.com/tr/guides/librechat-custom-endpoint/)
-   [Akıl yürüten model neden boş yanıt döndürür?](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/)
-   [Ajanlar için sınırsız LLM API planları nasıl çalışır?](https://broadrouter.com/tr/guides/unlimited-llm-api-sessions/)
-   [BroadNet Inference hata kodları ve ne zaman yeniden denenmeli](https://broadrouter.com/tr/guides/errors-and-retries/)
-   [BroadNet Inference ile çalışan tüm araçlar (İngilizce)](https://broadrouter.com/integrations/): SDK'lar, kodlama ajanları, sohbet arayüzleri ve otomasyon araçları, her biri için tam ayarlarıyla

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-open-webui-openai-api&utm_content=page-cta) ·

**Kaynaklar**

-   [Open WebUI belgeleri, OpenAI uyumlu sağlayıcılar (2026-11-16 tarihinde kontrol edildi)](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)
-   [Open WebUI belgeleri, ortam değişkeni yapılandırması (2026-11-14 tarihinde kontrol edildi)](https://docs.openwebui.com/reference/env-configuration)
-   [BroadNet Inference API referansı (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-open-webui-openai-api&utm_content=sources)
