Dokümantasyon

Open WebUI

Open WebUI, OpenAI uyumlu her uç noktayı bir bağlantı olarak ele alır. Yönetici Ayarları'ndan bir bağlantı ekleyin ya da kapsayıcı başlatılırken iki ortam değişkeni tanımlayın — her iki yol da aynı sonuca ulaşır.

Yönetici Ayarları altında tek bir OpenAI bağlantısı veya kapsayıcı başlangıcında OPENAI_API_BASE_URL ve OPENAI_API_KEY — ikisi de aynı /v1'de sonlanır.

Bağlantı veya docker run

# Settings → Admin Settings → Connections → Manage OpenAI API Connections → +
URL                https://api.kunavo.com/v1
API Key            sk-kn-...
Model IDs (Filter) claude-sonnet-5, claude-opus-5, claude-haiku-4-5, gpt-5-6-terra

# …or at container start, same thing:
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.kunavo.com/v1 \
  -e OPENAI_API_KEY=sk-kn-... \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

Model IDs (Filter) alanını doldurun. Bu alan olmadan seçicide, sohbet penceresinin çağıramadığı görsel, video ve müzik modelleri de dahil olmak üzere tüm katalog listelenir; böylece kullanıcının ilk tıklaması bunlardan birine denk gelir. Bu filtre, uç noktada /models rotası bulunmadığında da kullanılmalıdır; Kunavo'da bu rota vardır, dolayısıyla her iki durumda da doğrulama başarılı olur.

URL'de /v1 kalır. Open WebUI Docker'da çalışıyorsa ve aynı ana makinedeki bir kaynağa yönlendiriyorsanız localhost yerine host.docker.internal kullanın — bu, barındırılan bir uç nokta için geçerli değildir; ancak bu adımdan hemen sonra karşılaşılan hata budur.

Henüz anahtarınız yok mu? Bir Kunavo hesabı oluşturun, bir anahtar oluşturun ( sk-kn- ile başlar) ve $10'dan kredi ekleyin — çağrılar bu bakiyeden ödenir ve başarısız çağrılar ücretlendirilmez. Ardından kontrol paneli Open WebUI kurulumunda açılır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
Open WebUI'da Ayarlar → Yönetici → Bağlantılar bölümüne gidin ve OpenAI API Bağlantılarını Yönet seçeneğini bulun.
➕ Bağlantı Ekle seçeneğine tıklayıp URL'yi ve API Anahtarını girin.
İstediğiniz kimlikleri Model IDs (Filter) alanına ekleyin; ardından kaydedip bağlantının doğrulanmasını bekleyin.
Yeni bir sohbet başlatın — modeller seçicide bağlantı adı ön ekiyle görünür.

Open WebUI'ın OpenAI uyumlu sağlayıcı kılavuzu ile 6 Eylül 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar Open WebUI içinde çalışır.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Model kimliği	Kunavo giriş / çıkış	Open WebUI içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	genel amaçlı varsayılan sohbet modeli
`claude-opus-5`	$3.50 / $17.50	uzun analitik yazışmalar
`claude-haiku-4-5`	$0.70 / $3.50	hızlı ve ucuz; çoğu tur için yeterli
`gpt-5-6-terra`	$0.70 / $4.20	sohbet penceresine yapıştırılan uzun belgeler

Faturalandırma aylık ücret olmadan, ön ödemeli bakiyeden token başına yapılır — faturalandırmaya bakın. Tekrarlanan bağlamda — bir düzenleyicinin veya sohbet istemcisinin gönderdiği içeriğin çoğu budur — istem önbellekleme, faturayı model seçiminden daha fazla değiştirir.

Sık sorulan sorular

Open WebUI'ı OpenAI uyumlu bir API'ye nasıl bağlarım?

Ayarlar → Yönetici → Bağlantılar bölümüne gidin, "OpenAI API Bağlantılarını Yönet" seçeneğini açın ve Bağlantı Ekle'ye tıklayın; ardından uç nokta URL'sini — /v1 kökünü — ve API anahtarını girin. Aynı işlem, kapsayıcı başlatılırken OPENAI_API_BASE_URL ve OPENAI_API_KEY ortam değişkenleriyle de yapılabilir. Her iki yöntem de aynı bağlantıyı oluşturur.

Open WebUI'da Model IDs (Filter) ne işe yarar?

Bu alan, söz konusu bağlantıdaki hangi model kimliklerinin seçicide görüneceğini sınırlar. Ayrıca /models rotasını uygulamayan uç noktalar için alternatif yöntemdir: kimlikleri elle eklersiniz; doğrulama başarısız olsa da sohbet çalışır. Büyük ve çok modlu kataloğa sahip bir ağ geçidinde bu alanı her durumda ayarlamak faydalıdır; böylece sohbet seçicisinde yalnızca bir sohbet penceresinin gerçekten çağırabileceği modeller listelenir.

Open WebUI temel URL'sine /v1 dahil mi?

Evet. Open WebUI, verdiğiniz URL'ye yalnızca rotayı ekler; bu nedenle bağlantı URL'si /v1 köküdür — https://api.example.com/v1. Belgelerdeki uç nokta örnekleri de bu son eki içerir. Son ek olmadan bağlantı kaydedilir, ancak her istek 404 hatası verir.

Open WebUI, Claude ve GPT modellerini kullanabilir mi?

Evet, OpenAI uyumlu bir uç nokta üzerinden sunulduklarında. Open WebUI, model kimliğini doğrudan bağlantı URL'sine iletir; böylece herhangi bir satıcının kimlikleri Open WebUI'da değil uç noktada çözümlenir. Bu, tek bir bağlantı ve anahtarla Claude ve GPT kimliklerini aynı model seçicisinde kullanabileceğiniz anlamına da gelir.