LobeChat'i özel bir OpenAI uyumlu endpoint üzerinde çalıştırın.

Updated 2026-07-29

LobeChat'in sağlayıcı modülü herhangi bir OpenAI uyumlu hizmeti kabul eder: OpenAI SDK türünde özel bir sağlayıcı oluşturun, endpoint'i https://api.apisrouter.com/v1 olarak ayarlayın, tek bir anahtar yapıştırın ve model listesini getirin. Claude, GPT, Gemini ve DeepSeek id'leri her asistanın model seçicisine iner.

Hızlı yanıt: tek özel sağlayıcı, tek endpoint, tek anahtar.

LobeChat ayarlarını açın ve AI hizmet sağlayıcı bölümüne gidin (sürüme göre AI Service Provider veya Language Model olarak etiketlenir). Sağlayıcı-yönetim modülü v1.44'te geldiğinden beri, yerleşik OpenAI girdisine binmek yerine özel bir sağlayıcı oluşturabilirsiniz: bir sağlayıcı ekleyin, ona bir id ve görünen ad verin (apisrouter / APIsRouter), OpenAI SDK türünü seçin, ardından API anahtarını ve endpoint proxy URL'sini https://api.apisrouter.com/v1 ile doldurun. Sağlayıcının model listesinde, endpoint'in /v1/models üzerinden sunduğu her id'yi çekmek için modelleri-getir eylemini kullanın, istediklerinizi etkinleştirin ve yerleşik bağlanabilirlik kontrolünü çalıştırın. Bundan sonra, herhangi bir asistan veya konuşma bu id'leri model seçicisinden seçebilir. Proje artık GitHub'da lobehub/lobehub'da yaşıyor (lobe-chat depo adı oraya yönlendiriyor) ve menü etiketleri sürümler arasında kayıyor, bu yüzden akışı, sağlayıcı girdisi, SDK türü, URL, anahtar, getir, tam kelimeler yerine kararlı kısım olarak ele alın.

Provider ID:    apisrouter
Provider Name:  APIsRouter
SDK Type:       OpenAI
API Key:        sk-YOUR-APISROUTER-KEY
API Proxy URL:  https://api.apisrouter.com/v1

Model List → Fetch models → enable ids → check

LobeChat isteklerini bir sağlayıcıya nasıl yönlendirir.

LobeChat (kabaca 80K GitHub yıldızı, artık LobeHub adı altında), en çok dağıtılan açık kaynaklı sohbet çerçevelerinden biridir: cilalı bir web istemcisi, kendi promptları ve modelleri olan asistanlar, bir eklenti sistemi ve bilgi tabanı özellikleri; bir tarayıcı oturumunda veya bir veritabanıyla kendi barındırılarak dağıtılabilir. Her sağlayıcı girdisi, isteklerin nereye gittiğini ve hangi SDK lehçesinin konuşulacağını tanımlar. OpenAI SDK türündeki özel bir sağlayıcı, proxy URL'nize standart chat-completions isteklerini model id'sini düz bir string olarak göndererek gönderir; bu tam olarak çoklu-satıcı bir gateway'in beklediği şekildir. Bu yüzden tek bir girdi tüm katalogu taşır: asistanlar dikkatli iş için claude-sonnet-4-6'yı sabitleyebilirken hızlı konuşmalar hiçbir yerde ikinci bir hesap olmadan gemini-3.5-flash üzerinde çalışabilir. Endpoint URL'sinin alıntılanmaya değer belgelenmiş bir inceliği var: URL'nin bir /v1 sonekine ihtiyacı olup olmadığı, arkasındaki hizmete bağlıdır. LobeChat, verdiğiniz base'e /chat/completions gibi rota yolları ekler, bu yüzden APIsRouter için doğru değer https://api.apisrouter.com/v1'dir. Eksik bir sonekin belgelenmiş belirtisi, modelin testte boş bir yanıt döndürmesidir; bunu görürseniz /v1'i ekleyin ve yeniden deneyin.

Kendi barındırma: ortam-değişkeni yolu.

LobeChat'i kendiniz dağıtırsanız, aynı yönlendirme arayüze tıklanmak yerine container'da gelebilir. Klasik çift, yerleşik OpenAI sağlayıcısını geçersiz kılar: OPENAI_API_KEY gateway anahtarını alır ve OPENAI_PROXY_URL https://api.apisrouter.com/v1'i alır. O dağıtımın her kullanıcısı, ayarlara dokunmadan endpoint'i devralır. Model görünürlüğü, model-listesi sözdizimiyle kontrol edilir: OPENAI_MODEL_LIST eklemek için +id, gizlemek için -id ve yeniden etiketlemek için id=Görünen Ad kabul eder, girdiler virgülle ayrılır. Değeri -all ile başlatmak yerleşik listeyi temizler, böylece yalnızca açıkça belirttiğiniz id'ler görünür; bu, düzenlenmiş bir dağıtım için temiz şekildir. Daha yeni sunucu derlemeleri de, dağıtım zamanında tam özel sağlayıcıları bildirmek için bir CUSTOM_PROVIDER_* ailesini (count, id, name, type, base URL, keys) belgeler; bu, arayüz modülünün yaptığıyla eşleşir. Ona güvenmeden önce sürümünüz için güncel ortam-değişkeni referansını kontrol edin, çünkü bu yüzey OPENAI_* çiftinden daha yenidir ve hâlâ gelişmektedir.

OPENAI_API_KEY=sk-YOUR-APISROUTER-KEY
OPENAI_PROXY_URL=https://api.apisrouter.com/v1
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-6=Claude Sonnet 4.6,+gpt-5.5,+gemini-3.5-flash,+deepseek-v4-pro

Asistanlar için model seçmek.

Tüm asistanlar tek bir anahtar üzerinden faturalandığından, model karşılaştırması bir asistan-ayarları değişikliğidir. İki adayı iki yinelenen asistanda sabitleyin, gerçek promptlarınızı bir hafta çalıştırın ve APIsRouter konsolundaki model başına harcamayı gözlemlediğiniz yanıt kalitesinin yanında okuyun.

  • Asistanlar, rol başına model sabitlemeleridir. Bir yazma asistanı claude-sonnet-4-6'da, bir hızlı-yanıt asistanı claude-haiku-4-5-20251001'de ve bir araştırma asistanı gpt-5.5'te, hepsi tek bir sağlayıcı girdisinin arkasında bir arada var olur.
  • gemini-3.5-flash, varsayılan konuşma modeli için duyarlılık seçimidir; bir sohbet çerçevesindeki çoğu tur kısa ve hızlıdır, bu yüzden hızlı modeller arayüzü anında hissettirir.
  • deepseek-v4-pro, uzun çok dilli konuşmalar ve ağır özetleme için bir yeri hak eder; harcanan token başına uzun-bağlam davranışı buradaki çekiciliktir.
  • Görüntü konuşmaları, sağlayıcının model yapılandırmasında yetenek etkinleştirilmiş görüntü-yetenekli bir id'ye ihtiyaç duyar; LobeChat, sağlayıcı modülünde model başına yetenek anahtarları sunar.
  • İki katmanlı bir seçiciyi kasıtlı olarak etkinleştirin, bir hızlı id ve bir sınır id, ve yalnızca gerçek bir asistan ihtiyaç duyduğunda daha fazlasını ekleyin; her etkinleştirilen model, kullanıcıların kaydırdığı bir satırdır.

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.

ModelResmi FiyatBizim Fiyatımız
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
GPT-5.5$5.00 / $30.00 per M$4.00 / $24.00 per M
Gemini 3.5 Flash$1.50 / $9.00 per M$1.20 / $7.20 per M
DeepSeek V4 Pro$0.43 / $0.87 per M$0.40 / $0.90 per M
Claude Haiku 4.5 20251001$1.00 / $5.00 per M$0.80 / $4.00 per M

LobeChat'e özgü hata modları.

Bağlanabilirlik kontrolünde boş bir yanıt, bir base-URL soneki sorununun belgelenmiş belirtisidir. /v1'i ekleyin veya kaldırın (APIsRouter için mevcut olmalıdır) ve daha derine hata ayıklamadan önce yeniden deneyin. Bir asistanın seçicisinde eksik modeller genellikle getirildiklerini ama sağlayıcının model listesinde etkinleştirilmediklerini veya sağlayıcı geçişinin kendisinin kapalı olduğunu gösterir. İkisi de getir eylemiyle aynı ayarlar ekranında yaşar. Kendi barındırılan dağıtımlarda, önceliği hatırlayın: ortam değişkenleri sunucu tarafı varsayılanları yapılandırır, kullanıcılar ise dağıtımınızın kimlik doğrulama ve özellik bayraklarına bağlı olarak istemci tarafında kendi sağlayıcı ayarlarını hâlâ girebilir. Bir dağıtım OPENAI_PROXY_URL'nizi yok sayıyorsa, container'ın gerçekten yeni ortamla yeniden başladığını ve istemci oturumunun onu yerel olarak geçersiz kılmadığını doğrulayın. Sürüm kayması burada gerçektir: ayarlar ağacı birden fazla kez yeniden düzenlendi (Language Model, ardından AI Service Provider; sağlayıcı modülü v1.44'te geldi) ve eski eğitimlerdeki ekran görüntüleri güncel menülerle eşleşmeyecektir. Alanların kendisi, id, ad, SDK türü, URL, anahtar, sabit kalmıştır.

LobeChat'i bir gateway üzerinden kim yönlendirir.

  • Bir ekip için LobeChat'i kendi barındıran ve kullanıcı başına satıcı anahtarları yerine container'da tek bir endpoint ve herkes için tek bir kullanım günlüğü isteyen kendi-barındıranlar.
  • Her rol için farklı satıcı sabitleyen, her biri için hesap sürdürmeden yazma için Claude, analiz için GPT, hacim için DeepSeek isteyen asistan güç kullanıcıları.
  • Yerleşik sağlayıcı listesinin taşımadığı modelleri, upstream sürümlerini beklemek yerine gateway katalogunu getirerek etkinleştiren kullanıcılar.
  • Belirli bir satıcının faturalandırmasına erişimi olmayan geliştiriciler. Kart gerektirmeyen yükleme tabanlı erişim, sağlayıcı başına kayıt bağımlılığını ortadan kaldırır.
  • Zaten editörlerini, başlatıcılarını veya CLI araçlarını bir gateway üzerinden yönlendiren ve sohbet çerçevelerini aynı anahtarda isteyen kişiler.

Endpoint'i doğrulayın ve ilk konuşmayı hata ayıklayın.

Önce model listesini curl'leyin ve çıktıyı açık tutun; bu, ister getirerek ister elle etkinleştirdiğiniz her id için yetkili yazımdır. Ardından varsayılan yapmayı planladığınız id'ye karşı bir chat completion çalıştırın. LobeChat içinde, gerçek konuşmalardan önce bağlanabilirlik kontrolünü çalıştırın. Kimlik doğrulama başarısızlıkları anahtar alanına işaret eder. Boş bir yanıt /v1 sonekine işaret eder. Belirli bir modelde bulunamadı hataları, etkinleştirilen id'nin listeyle eşleşmediği anlamına gelir; bu çoğunlukla görünen adları ve id'leri birlikte elle düzenledikten sonra olur. Konuşmalar akmaya başladığında, APIsRouter konsolu istek başına modeli, token sayılarını ve harcamayı gösterir. Asistanlı bir sohbet çerçevesi, birkaç model genelinde aynı anda trafik üretir ve anahtar başına kullanım görünümü, her asistanın alışkanlığının model başına, gün başına görebileceğiniz bir maliyet haline geldiği yerdir.

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":"gemini-3.5-flash",
       "messages":[{"role":"user","content":"ping"}]}'

Sık sorulan sorular

LobeChat'e özel bir OpenAI uyumlu sağlayıcıyı nasıl eklerim?

Ayarlarda AI hizmet sağlayıcı bölümünü açın ve özel bir sağlayıcı oluşturun: id ve görünen ad, SDK türü OpenAI, endpoint https://api.apisrouter.com/v1 ve anahtarınız. Model listesini getirin, istediğiniz id'leri etkinleştirin ve bağlanabilirlik kontrolünü çalıştırın.

Endpoint URL'sinin /v1'e ihtiyacı var mı?

APIsRouter için evet: https://api.apisrouter.com/v1. LobeChat, verdiğiniz base'e /chat/completions gibi rotalar ekler ve belgeleri, yanlış bir sonekin genellikle testte boş bir yanıt olarak ortaya çıktığını not eder. Bunu görürseniz soneki düzeltin ve yeniden deneyin.

OPENAI_PROXY_URL nedir ve ne zaman kullanırım?

LobeChat'in yerleşik OpenAI sağlayıcısını başka bir base URL'ye yeniden yönlendiren kendi-barındırma ortam değişkenidir. Onu container'da OPENAI_API_KEY ile ayarlayın ve o dağıtımın her kullanıcısı endpoint'i devralır; hangi id'lerin göründüğünü düzenlemek için OPENAI_MODEL_LIST'i kullanın.

Farklı asistanlar tek bir sağlayıcı üzerinden farklı satıcılar kullanabilir mi?

Evet. Her asistan kendi modelini sabitler ve id, istek başına düz bir string olarak endpoint'e seyahat eder. Tek bir sağlayıcı girdisi, hepsi aynı anahtar üzerinden faturalanan bir Claude asistanına, bir GPT asistanına ve bir DeepSeek asistanına yan yana hizmet edebilir.

LobeChat, LobeHub ile aynı proje mi?

Evet. Proje yeniden markalandı ve GitHub deposu artık lobehub/lobehub'da yaşıyor; eski lobe-chat adı oraya yönlendiriyor. Belgeler ve menüler geçiş sırasında her iki adı da karıştırıyor; bu, ayar etiketlerinin sürümler arasında değişmesinin de nedenidir.

Getirdiğim modeller neden konuşmalarda görünmüyor?

Getirmek id'leri listeler; onları etkinleştirmek, sağlayıcının model listesinde model başına ayrı bir geçiştir ve sağlayıcının kendisinin de bir etkinleştirme anahtarı vardır. İkisini de kontrol edin, ardından model seçicisini yeniden açın. Etkinleştirilmiş bir id hâlâ hata veriyorsa, yazımını /v1/models çıktısıyla karşılaştırın.