Dokümantasyon

LobeChat

Kendi sunucunuzda barındırdığınız LobeChat'in Kunavo'ya bağlanması için üç ortam değişkeni gerekir: bir anahtar, bir proxy URL'si ve seçicide görünmesini istediğiniz model kimliklerinin listesi.

OPENAI_API_KEY değerini sk-kn-… anahtarınız olarak, OPENAI_PROXY_URL değerini https://api.kunavo.com/v1 olarak ayarlayın ve istediğiniz kimlikleri OPENAI_MODEL_LIST alanında belirtin. Böylece Claude ve GPT aynı seçiciyi ve aynı bakiyeyi paylaşır.

.env

OPENAI_API_KEY=sk-kn-...
OPENAI_PROXY_URL=https://api.kunavo.com/v1

# LobeChat only shows models it knows about, so name the ones you want.
OPENAI_MODEL_LIST=claude-sonnet-5,claude-haiku-4-5,claude-opus-5,gpt-5-6-terra

/v1 son eki OPENAI_PROXY_URL içinde bulunmalıdır. LobeChat, OpenAI yolunu yeniden oluşturmak yerine verdiğiniz URL'ye istek iletir; bu nedenle kendi .env.example dosyası varsayılanı son ek dâhil https://api.openai.com/v1 olarak belirtir.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
Üç değişkeni dağıtımınızın ortamına ekleyin: yalın kurulumda .env dosyasına, Docker'da ise environment bloğuna.
Yeni ortam değişkenlerinin okunması için kapsayıcıyı yeniden başlatın.
LobeChat'i açın, bir oturum başlatın ve OPENAI_MODEL_LIST'te listelediğiniz kimliklerden birini seçin.

docker-compose.yml

services:
  lobe-chat:
    image: lobehub/lobe-chat
    ports:
      - "3210:3210"
    environment:
      OPENAI_API_KEY: sk-kn-...
      OPENAI_PROXY_URL: https://api.kunavo.com/v1
      OPENAI_MODEL_LIST: claude-sonnet-5,claude-haiku-4-5,gpt-5-6-terra

LobeChat'in bu değişkenlere ilişkin kendi başvuru kaynağı model sağlayıcısı ortam değişkenleri sayfasıdır.

Kapsayıcıda hata ayıklamadan önce doğrulayın

Tek bir istek, sorunun uç noktada mı, anahtarda mı yoksa LobeChat'in model listesinde mi olduğunu belirler. Bu istek model kimliklerinden oluşan bir JSON listesi döndürüyorsa aynı URL ve anahtar çalışıyor demektir; bundan sonra seçici boşsa sorun uç noktada değil, OPENAI_MODEL_LIST'tedir.

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

Listelenecek kimlikler

Kunavo'daki tüm metin modellerini OPENAI_MODEL_LIST değişkenine ekleyebilirsiniz. Tam liste modeller sayfasında yer alır ve GET /v1/models isteğiyle anlık olarak alınır. Ücretler 1M token başına USD cinsindendir; giriş / çıkış.

Model kimliği	Kunavo giriş / çıkış	Kullanım alanı
`claude-haiku-4-5`	$0.70 / $3.50	En ucuz Claude — tur başına maliyetin önemli olduğu uzun sohbet oturumları
`claude-sonnet-5`	$1.40 / $7.00	Kalite ve fiyat arasında varsayılan denge
`claude-opus-5`	$3.50 / $17.50	En yüksek kaliteli Claude katmanı
`gpt-5-6-terra`	$0.70 / $4.20	Aynı anahtar, farklı aile — yapılandırılacak ikinci bir sağlayıcı yok

Bir sohbet istemcisi her turda konuşmanın tamamını yeniden gönderir; bu nedenle LobeChat'teki token harcaması mesaj başına sabit kalmak yerine oturum uzadıkça artar. Bu kullanım biçiminde en etkili araç istem önbelleğe almadır. Faturalandırma, aylık ücret olmadan ön ödemeli bakiyeden token başına yapılır; dolayısıyla kullanılmayan bir ayın maliyeti yoktur. Ayrıntılar için faturalandırma sayfasına bakın.

Sık sorulan sorular

LobeChat'i özel bir OpenAI uyumlu uç noktaya nasıl yönlendiririm?

Dağıtım ortamında OPENAI_PROXY_URL değerini uç noktanın temel URL'sine, OPENAI_API_KEY değerini ise anahtarınıza ayarlayın; Kunavo için bu URL https://api.kunavo.com/v1 şeklindedir. LobeChat'in kendi .env.example dosyasında bu değişken için örnek değer olarak https://api.openai.com/v1 kullanılır; bu da /v1 son ekinin değerin bir parçası olması gerektiğini ve sizin için otomatik olarak eklenmediğini hatırlatır.

Özel modelim neden LobeChat'in model listesinde görünmüyor?

LobeChat, uç noktanın sunabildiği tüm modeller yerine kendisine bildirilen modelleri görüntüler. Bu nedenle, uç nokta yanıt verse bile listesinde bulunmayan bir model kimliği görünmez. Kimlikleri OPENAI_MODEL_LIST içinde virgülle ayrılmış bir liste olarak belirtin. LobeChat'in belgelerinde bu değişken için bir önek söz dizimi de tanımlanır: baştaki + bir model ekler, baştaki - bir modeli gizler, model_name=display_name ise seçicide modelin görünen adını değiştirir.

LobeChat, OpenAI sağlayıcısı üzerinden Claude modellerini kullanabilir mi?

Evet, OpenAI uyumlu bir uç nokta üzerinden sunulduklarında. LobeChat'in OpenAI sağlayıcısı, model kimliğini OPENAI_PROXY_URL ile belirtilen adrese gönderir; dolayısıyla Claude kimliği LobeChat içinde değil, ağ geçidinde çözülür ve Anthropic kimlik bilgileri kullanılmaz. Kunavo'da Claude ve GPT kimlikleri tek bir anahtarın arkasındadır; bu nedenle bir model ailesi eklemek için OPENAI_MODEL_LIST'e bir kimlik eklemeniz yeterlidir.

LobeChat'in görüntü oluşturma özelliği özel bir uç nokta üzerinden çalışır mı?

Bu, LobeChat'e değil, uç noktanın hangi yolları uyguladığına bağlıdır. Sohbet sağlayıcısı /v1/chat/completions yolunu gerektirir; görüntü oluşturma ise ayrı bir yol kullanır. Kunavo, görüntü ve video oluşturmayı kendi uç noktalarında uygular; bunlar images ve video başlıkları altında belgelenmiştir. Bu nedenle güvenilir yöntem, sohbet için LobeChat'i kullanıp medya uç noktalarını doğrudan çağırmaktır; tek bir sağlayıcı ayarının her ikisini de kapsadığını varsaymayın.