Open WebUI'yi özel bir OpenAI uyumlu endpoint'e bağlayın.

Hızlı yanıt: Admin Settings'te tek bir bağlantı.

Bir yönetici olarak Admin Settings'i açın, Connections'a gidin ve OpenAI API bölümünün altında bir bağlantı eklemek için tıklayın. İki alan önemlidir: https://api.apisrouter.com/v1 olarak ayarlanan URL ve API anahtarı. Kaydedin, ve Open WebUI, model seçicisini doldurmak için endpoint'in /v1/models listesini sorgular; bağlantının kontrol denetleyicisiyle doğrulayın, ardından yeni bir sohbette herhangi bir katalog id'sini seçin. Bu şekilde eklenen bağlantılar çalışma alanı geneli geçerlidir: Open WebUI örneğinizin her kullanıcısı, yapılandırdığınız model-erişim kontrollerine tabi olarak modelleri görür. Aynı değerler, dağıtım zamanında ortam değişkenleri olarak da gönderilebilir, OPENAI_API_BASE_URL ve OPENAI_API_KEY; bu, örnek arayüze tıklanarak değil compose dosyalarıyla sağlandığında daha temiz bir yoldur.

URL:      https://api.apisrouter.com/v1
API Key:  sk-YOUR-APISROUTER-KEY

Save → models auto-populate from /v1/models
(optional) Model IDs allowlist to curate the selector

Open WebUI OpenAI bağlantılarını nasıl kullanır.

Open WebUI (kabaca 145K GitHub yıldızı), varsayılan kendi-barındırılan AI sohbet ön yüzüdür: kullanıcılar ve izinler, RAG ve bilgi koleksiyonları, tool kullanımı ve model yönetimi ile tam özellikli bir web istemcisi; klasik olarak yerel modeller için Ollama ile eşleştirilir ama uzak API'lerle konuşmakta da aynı derecede evindedir. Bağlantı modeli katmanlıdır. Ollama bölümü yerel çalışma zamanlarını kapsar; OpenAI API bölümü standart chat-completions lehçesini konuşan herhangi bir endpoint'i kapsar ve birkaç bağlantıyı yan yana ekleyebilirsiniz. Her bağlantı, model listesini paylaşılan seçiciye katkıda bulunur, her birinin kendi anahtarı vardır ve her biri yapılandırmasını silmeden kapatılabilir. İstekler, model id'sini düz bir string olarak onu sunan bağlantıya taşır. Bu tasarım, bir gateway bağlantısının hiçbir şeyin yerini almadığı anlamına gelir: yerel modelleriniz Ollama üzerinden token başına maliyet olmadan çalışmaya devam ederken, claude-sonnet-4-6, gpt-5.5, gemini-3.5-flash ve deepseek-v4-pro sınır kalite gerektiren konuşmalar için seçici girdileri haline gelir. Tek bir anahtar hepsini kapsar ve bulut trafiği tam olarak tek bir yerden çıktığından yönetici tarafı kullanım okunabilir kalır.

Dağıtım-zamanı kurulum: ortam değişkenleri.

Docker-compose ve Kubernetes dağıtımları için, bağlantı manifestin bir parçası olabilir. OPENAI_API_BASE_URL endpoint'i ve OPENAI_API_KEY anahtarı alır; örnek, bağlantı zaten mevcut olarak açılır. Birden fazla uzak kaynak çalıştırıyorsanız, çoğul biçimler (noktalı virgülle ayrılmış değerlerle OPENAI_API_BASE_URLS ve OPENAI_API_KEYS) üzerinden birden fazla endpoint desteklenir. İki operasyonel not. Birincisi, arayüz üzerinden ayarlanan değerler Open WebUI'nin veritabanında kalıcı olur ve ilk açılıştan sonra ortam varsayılanlarına göre önceliklidir; bu, ortamı değiştirip hiçbir şeyin olmadığını gören operatörleri düzenli olarak şaşırtan belgelenmiş bir davranıştır. Mevcut bağlantıları Admin Settings'te düzenleyin veya ortamın yetkili kalmasını istiyorsanız ENABLE_PERSISTENT_CONFIG=false ayarlayın. İkincisi, endpoint'in model listesi büyükse, kullanıcılarınızın ne gördüğünü düzenlemek için bağlantının Model IDs izin listesini kullanın; dört öğeli bir seçici kullanılır, iki yüz öğeli olan kaydırılıp geçilir. Sürüm notu: menü ifadeleri projenin hızlı yayın temposu boyunca kaymıştır (Settings ile Admin Settings, Connections içindeki bölüm adları), bu yüzden daha eski derlemelerde bağlantıların yaşadığı her yerde OpenAI API base URL ve anahtar çiftini arayın.

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    environment:
      - OPENAI_API_BASE_URL=https://api.apisrouter.com/v1
      - OPENAI_API_KEY=sk-YOUR-APISROUTER-KEY
    ports:
      - "3000:8080"

Çok kullanıcılı bir çalışma alanı için model seçmek.

Her bulut modeli tek bir anahtar üzerinden faturalandığından, A/B testi bir seçici seçimidir. Aynı ekip iş yükünü iki hafta arayla iki aday varsayılan üzerinde çalıştırın ve APIsRouter konsolundaki model başına kullanım görünümünün, benchmark'lardan tahmin etmek yerine model başına ve gün başına hakemlik yapmasına izin verin.

• Varsayılan-model seçimi, paylaşılan bir örnekte en çok işi yapar. Çalışma alanı varsayılanı olarak claude-haiku-4-5-20251001 veya gemini-3.5-flash, gündelik kullanımın konuşma başına maliyetini düz tutar.
• claude-sonnet-4-6 ve gpt-5.5, taslak, analiz ve kod soruları için seçicide yer alır; kullanıcılar görev hak ettiğinde yükselir.
• RAG pipeline'ları girdi token'larını çoğaltır: her yanıt getirilen parçaları taşır. deepseek-v4-pro, harcanan token başına uzun-bağlam işlemenin belirleyici özellik olduğu RAG iş atı olarak test edilmeye değer.
• Gerçekten özel materyali Ollama üzerinden yerel modellerde tutun ve geri kalanını gateway üzerinden yönlendirin; seçici her iki şeridi de dürüstçe tutar.
• Model IDs izin listesini politika olarak kullanın: seçicide olmayan şey kullanım günlüğünde sizi şaşırtamaz.

Kullandıkça öde · resmi fiyatların altında

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Open WebUI'ye özgü hata modları.

Bağlantıyı ekledikten sonra hiçbir modelin görünmemesi en yaygın rapordur. Nedenler sırasıyla: anahtar /v1/models'a karşı başarısız oldu (bağlantının doğrulama denetleyicisiyle kontrol edin), URL /v1 sonekini kaçırıyor veya bağlantı geçişi kapalı. Open WebUI seçiciyi listenin döndürdüğünden oluşturur, bu yüzden boş bir seçici, listeleme çağrısının başarısız olduğu veya hiçbir şey döndürmediği anlamına gelir. Yok sayılmış gibi görünen ortam değişikliği, yukarıda tanımlanan kalıcı-yapılandırma kuralıdır: ilk açılıştan sonra, arayüzün yönettiği ayarlar için veritabanı ortama göre kazanır. Bağlantıyı Admin Settings'te düzenleyin veya kalıcı yapılandırmayı açıkça devre dışı bırakın. Listelenen ama sohbette hata veren bir model genellikle listenin gösterdiği ama anahtarınızın kullanamadığı bir id'dir, veya Model IDs izin listesini elle düzenlerken getirilen bir yazım hatasıdır; ham /v1/models çıktısıyla karşılaştırın. Ve hata ayıklarken şeritleri düz tutun: Ollama bağlantı sorunları ve OpenAI bağlantı sorunları sohbet penceresinden aynı görünür. Connections sayfası bir modelin hangi şeride ait olduğunu gösterir; tüm örneğin çalışmadığını varsaymadan önce başarısız olan şeridi doğrudan test edin.

Open WebUI'yi bir gateway üzerinden kim yönlendirir.

• Herkes için tek bir sohbet ön yüzünü kendi barındıran, bireysel kullanıcılara satıcı anahtarları vermeden sınır modelleri kullanılabilir isteyen ekipler.
• Özel iş için yerel modelleri tutan ama gerektiren konuşmalar için aynı seçicide Claude ve GPT kalitesi isteyen Ollama kullanıcıları.
• Bulut faturasını okunabilir isteyen yöneticiler: tek bir bağlantı, tek bir anahtar ve dört satıcıdan makbuz yerine model başına bir kullanım günlüğü.
• Bazı satıcı kayıtlarının can sıkıcı olduğu bölgelerdeki operatörler; kart gerektirmeyen yükleme tabanlı erişim, sağlayıcı başına bağımlılığı ortadan kaldırır.
• Hane için Open WebUI çalıştıran, tek bir ön ödemeli bakiyenin herhangi bir abonelikten daha kolay akıl yürütülebilir olduğu ev laboratuvarı kullanıcıları.

Endpoint'i doğrulayın ve ilk sohbeti hata ayıklayın.

Endpoint'i özellikle container'ın ağının dizüstünüzünki olmadığı container'lı dağıtımlarda önce sunucudan kanıtlayın. Host içinden bir model listesi ve bir chat completion, Open WebUI resme girmeden önce gateway yarısını doğrular. Ardından bağlantıyı ekleyin ve seçicinin dolduğunu izleyin. Kimlik doğrulama hataları anahtar alanıdır; boş bir seçici listeleme çağrısıdır; sunucu günlüklerinde ikiye katlanmış bir yol (/v1/v1/...), URL alanının zaten bir /v1 taşıdığı ve bir şeyin bir tane daha eklediği anlamına gelir, bu yüzden URL'yi tam olarak kaydedildiği gibi okuyun. Sohbetler akmaya başladığında, APIsRouter konsolu istek başına modeli, token sayılarını ve harcamayı gösterir. Çok kullanıcılı bir örnek için önemli olan sayı budur: kullanıcılarınızın gerçekte hangi modelleri seçtiği ve bir haftalık çalışma alanının gerçekte neye mal olduğu, model başına, gün başına, tek bir sayfada.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Sık sorulan sorular