İçeriğe geç
Geliştirici Kaynakları
Geliştirici Kaynakları

Open WebUI

Open WebUI'yi yükleyin, RunAPI'yi OpenAI uyumlu bir bağlantı olarak ekleyin, bir model seçin ve sohbeti doğrulayın.

Markdown'ı görüntüle

Open WebUI’yi OpenAI uyumlu Bağlantısı aracılığıyla RunAPI’ye bağlayın. Open WebUI yönetici erişimine ve Kimlik Doğrulama Kılavuzu‘ndan alınmış standart bir RunAPI API anahtarına ihtiyacınız vardır.

Open WebUI'yi Yükle

Platformunuz için resmi Open WebUI hızlı başlangıç kılavuzunu takip edin. Yerel bir Docker kurulumu için resmi imaj şu komutla başlatılabilir:

SHELL 
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main

Uygulamayı açın, yönetici hesabı oluşturun ve bağlantıyı eklemeden önce oturum açın.

RunAPI bağlantısını ekleyin

  1. Admin Settings → Connections → OpenAI bölümünü açın, ardından Add Connection seçeneğini belirleyin.
  2. URL’yi https://runapi.ai/v1 olarak ayarlayın ve RunAPI API anahtarınızı girin.
  3. Open WebUI’nin mevcut modelleri keşfedebilmesi için ilk bağlantı denemesinde Model IDs (Filter) alanını boş bırakın.
  4. Bağlantıyı kaydedin ve doğrulamanın tamamlanmasını bekleyin.

Open WebUI, bağlantı kontrolünü arka ucundan gönderir ve keşif için GET /v1/models kullanır. RunAPI URL’si genel HTTPS olduğundan, bir Docker kurulumunun bu bağlantı için host.docker.internal kullanmasına gerek yoktur.

Bir model seçin

Yeni bir sohbet açın ve sohbet modeli seçicisinden bir RunAPI modeli seçin. Güncel model tanımlayıcısını ve yeteneklerini doğrulamak için Model Kataloğu‘nu kullanın.

Keşif seçiciyi doldurmuyorsa bağlantıyı düzenleyin ve Model IDs (Filter) altına tam tanımlayıcıyı ekleyin. Model keşif hatası ile Chat Completions hatası birbirinden bağımsız sinyallerdir; bağlantıyı kaldırmadan önce elle eklenen modeli test edin.

Bağlantıyı doğrulayın

Reply with the word connected. gibi kısa bir istem gönderin. Normal bir akışlı veya tam yanıt, Open WebUI’nin seçili RunAPI modelini kullanabildiğini doğrular.

Sorun giderme

  • Doğrulama 401 veya 403 döndürüyor: Bağlantıdaki API anahtarını Kimlik Doğrulama Kılavuzu üzerinden alınan geçerli bir standart anahtarla değiştirin.
  • Hiçbir RunAPI modeli görünmüyor: URL’nin /v1 ile bittiğini onaylayın, ardından Model IDs (Filter) alanına güncel bir tanımlayıcı ekleyip sohbeti yeniden deneyin.
  • Model görünüyor ancak sohbet başarısız oluyor: Tanımlayıcının Model Kataloğu sayfasında OpenAI uyumlu Chat Completions desteklediğini onaylayın, ardından istek durumu için Open WebUI arka uç günlüklerini inceleyin.
  • Yerel URL tarayıcıda çalışıyor ancak Open WebUI’da çalışmıyor: Open WebUI bağlantıları arka ucundan kaynaklanır. Bu, genel https://runapi.ai/v1 URL’sini etkilemez; ancak diğer yerel bağlantılar için önemlidir.

Ortak protokol davranışı için LLM API Hızlı başlangıç bölümünü kullanın. İstek ve yanıt alanları için Chat Completions API Başvurusu bölümüne bakın.