Dokümantasyon

NextChat

Kendi sunucunuzda barındırdığınız NextChat, Kunavo’ya OpenAI için zaten kullandığı değişkenlerle bağlanır: OPENAI_API_KEY anahtarı, BASE_URL kaynak adresini, CUSTOM_MODELS ise kimlikleri içerir. Fork veya yama gerekmez.

Üç ortam değişkeni — OPENAI_API_KEY, BASE_URL (yalnızca origin) ve CUSTOM_MODELS — kendi barındırdığınız bir NextChat'i tek anahtarla Claude ve GPT'ye bağlar.

Ortam değişkenleri — Vercel proje ayarları, docker -e veya .env.local

CODE=your-access-password
OPENAI_API_KEY=sk-kn-...
BASE_URL=https://api.kunavo.com
HIDE_USER_API_KEY=1
CUSTOM_MODELS=-all,+claude-sonnet-5@OpenAI,+claude-opus-5@OpenAI,+claude-haiku-4-5@OpenAI,+gpt-5-6-sol@OpenAI,+gpt-5-6-terra@OpenAI

BASE_URL alanına, /v1 olmadan yalın kaynak adresini girin. Belgeler sayfasında son ekle ilgili bir cümle bulunmasa da kendi satırı konuyu açıklığa kavuşturur: belgelenen varsayılan https://api.openai.com, https://api.openai.com/v1 değildir; yolun geri kalanını NextChat ekler. Elle eklediğiniz bir /v1 değeri /v1/v1/chat/completions olur; bu da 404 ile sonuçlanır ve yazım hatasından çok, uç noktanın bozuk olduğu izlenimini verir.

Anahtarı kimin tutacağı, varsayılan bir ayar değil, dağıtım kararıdır. OPENAI_API_KEY ayarlandığında sunucu, Kunavo’ya sizin anahtarınızla çağrı yapar ve CODE aşamasını geçen herkes bakiyenizden harcama yapar. HIDE_USER_API_KEY=1 için “Kullanıcıların kendi API anahtarlarını girmesini istemiyorsanız bu değeri 1 olarak ayarlayın” ifadesi belgelenmiştir. Bu ayarı belirlemezseniz her ziyaretçi Ayarlar’a kendi anahtarını girebilir; paylaşılan bir örnek için gereken yapılandırma budur.

-all öneki ve @OpenAI son eki belgelenmiş tabloda yer almaz; tabloda yalnızca +, - ve name=displayName bulunur. Bunlar aynı gün incelenen NextChat’ın kendi model koleksiyonu kodundan alınmıştır: -all yerleşik listeyi temizleyerek seçicide Kunavo’nun reddedeceği kimliklerin sunulmasını engeller; @OpenAI ise her yeni kimliği OpenAI sağlayıcısına sabitleyerek BASE_URL adresine gönderilmesini sağlar. Son eki olmadan yazılan bir kimlik, kendi adını taşıyan bir sağlayıcı oluşturur ve yapılandırdığınız yolu izlemez. Büyük ve küçük harf kullanımı aynen korunmalıdır.

Kunavo sesli metin okuma veya sesten metne dönüştürme modeli sunmadığından, NextChat’ın ses özelliklerinin burada kullanabileceği bir model yoktur. ENABLE_BALANCE_QUERY ayarını da belirlemeyin: bakiye kontrolü OpenAI’ın kendi kontrol panelindeki faturalandırma yollarını çağırır ve bunlar OpenAI uyumlu arayüzün parçası değildir. Bakiyeniz /app/billing üzerindedir.

Bu sayfa bir test çalıştırmasından değil, NextChat belgelerinden derlenmiştir: Kunavo, NextChat'i bu uç noktaya karşı çalıştırmamıştır ve yayımlanmış bir kurulum sayfası uyumluluk testi değildir. Her iki tarafta da belgelenen arayüz sohbet tamamlama uç noktalarıdır; bunun ötesindeki her şey burada test edilmemiştir.

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 NextChat kurulumunda açılır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
OPENAI_API_KEY değerini bu anahtara, BASE_URL değerini de https://api.kunavo.com olarak ayarlayın. Vercel'de bunlar proje ortam değişkenleridir; Docker'da -e bayraklarıdır; yerel ortamda ise .env.local içine konur.
CODE değerini bir erişim parolası olarak ayarlayın; yoksa URL'yi bulan herkes dağıtımınıza erişebilir ve masraf sizin anahtarınıza yansır.
İstediğiniz kimlikleri, yerleşik kimlikleri kaldırmak için -all ile başlayarak CUSTOM_MODELS içine yazın; her birinin sonuna @OpenAI ekleyin.
Yeniden dağıtım yapın: ortam değişkenleri sunucu tarafından okunur, bu nedenle Vercel projesi için yeni bir dağıtım gerekir; kapsayıcı da yeniden başlatılmalıdır. Değişkeni düzenlemek, çalışan bir örneği tek başına değiştirmez.
Uygulamayı açın, model seçicisinden kendi kimliklerinizden birini seçin ve bir ileti gönderin. Yanıt gelirse üç değişken birbiriyle uyumludur.

NextChat'in Ortam Değişkenleri sayfası ile 21 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 NextChat 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ış	NextChat içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	bakiyeyi sürekli kontrol etmeden uzun sohbetler için günlük kullanım
`claude-opus-5`	$3.50 / $17.50	pahalı modeli hak eden haftanın tek sorusu
`claude-haiku-4-5`	$0.70 / $3.50	özetleme, sohbetleri yeniden adlandırma ve paylaşılan bir örnekteki kısa karşılıklı yazışmalar
`gpt-5-6-sol`	$2.00 / $12.00	aynı seçicide, aynı anahtarla ikinci bir model ailesi
`gpt-5-6-terra`	$0.70 / $4.20	bağlam penceresinin belirleyici olduğu, yapıştırılmış 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

NextChat'i özel bir API uç noktasına nasıl yönlendirebilirim?

Kendi kendine barındırılan dağıtımda BASE_URL değerini uç noktanın kaynağına, OPENAI_API_KEY değerini ise sağlanan anahtara ayarlayın ve ikisini de ortam değişkeni olarak tanımlayın. NextChat'in kendi Ortam Değişkenleri sayfasında BASE_URL, "OpenAI API istek temel URL'sini geçersiz kıl" şeklinde belgelenmiştir; dolayısıyla herhangi bir yamaya gerek yoktur: uygulama OpenAI tel biçimini kullanmayı sürdürür ve istekleri başka bir adrese gönderir. Ardından yeniden dağıtım yapın; değerler sunucuda okunur, bu yüzden çalışan bir örnek bunları kendiliğinden almaz.

NextChat BASE_URL değerinin sonunda /v1 olmalı mı?

Hayır. NextChat sürüm bölümünü ve rotanın kendisini ekler; bu nedenle BASE_URL için belgelenen varsayılan değer https://api.openai.com/v1 değil, https://api.openai.com şeklindeki yalın kaynaktır. https://api.kunavo.com yazın, başka bir şey eklemeyin. Son eki kendiniz eklerseniz yol iki kez yazılır ve 404 hatası alırsınız; bu da uç noktanın çalışmadığını sanmanıza yol açabilir.

NextChat'in model listesine özel bir modeli nasıl eklerim?

CUSTOM_MODELS, virgülle ayrılmış bir liste alır: + model ekler, - modeli gizler, name=displayName ise modelin adını değiştirir. NextChat'in tanımadığı bir kimlik anında oluşturulur; dolayısıyla +claude-sonnet-5@OpenAI bu kimliği seçiciye ekler. İki ayrıntıyı aynen uygulayın: yerleşik OpenAI kimliklerinin biri seçildiğinde hata vermek yerine kaldırılması için listeyi -all ile başlatın ve kimliğin model adına göre adlandırılmış bir sağlayıcıya değil, BASE_URL üzerinden yönlendirilmesi için @OpenAI son ekini koruyun.

NextChat sunucu API anahtarını mı kullanmalı, yoksa her kullanıcı kendi anahtarını mı girmeli?

Her iki seçenek de desteklenir; seçim, ödemeyi kimin yapacağına bağlıdır. OPENAI_API_KEY içindeki anahtar sunucuya aittir; bu nedenle CODE parolasını geçen her ziyaretçinin harcaması aynı bakiyeden düşer. Özel bir örnek için uygun, herkese açık paylaşılan bağlantı için maliyetli olabilir. HIDE_USER_API_KEY tanımlanmadan bırakılırsa ziyaretçiler Ayarlar'a kendi anahtarlarını girip ödemeyi kendileri yapabilir; bu değişken 1 olarak ayarlanırsa ilgili alan kaldırılır. Her iki durumda da anahtar, kullanıcı tarafından tarayıcıya yazılmadıkça tarayıcıya ulaşmaz.