Dokümantasyon

SillyTavern

SillyTavern'ın Custom (OpenAI-compatible) kaynağı için bir temel URL ve anahtar gerekir. Kunavo'ya yönlendirdiğinizde Claude ve GPT aynı model açılır listesinde görünür.

SillyTavern'ı Kunavo'ya bağlamak için API Connections bölümünü açın, API ayarını Chat Completion, Chat Completion Source ayarını da Custom (OpenAI-compatible) olarak belirleyin. Ardından iki alanı doldurun: Custom Endpoint = https://api.kunavo.com/v1, Custom API Key = sk-kn-… anahtarınız. Connect'e basın; SillyTavern GET /v1/models çağrısını yapar ve model açılır listesini yanıttan doldurur.

SillyTavern alanı	Değer
API	Chat Completion
Chat Completion Source	Custom (OpenAI-compatible)
Custom Endpoint (Base URL)	`https://api.kunavo.com/v1`
Custom API Key	`sk-kn-…`
Available Models	Connect'ten sonra kendiliğinden dolar — istediğiniz id'yi seçin

/v1 soneki bu alanda bulunmalıdır. SillyTavern'ın özel kaynağı OpenAI kuralını izleyerek yalnızca yolu ekler; bu nedenle /v1 olmadan https://api.kunavo.com kullanıldığında bağlantı başarısız olur ve model listesi boş kalır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
SillyTavern'da üst çubuktaki fiş simgesini (API Connections) açın.
API → Chat Completion ve ardından Chat Completion Source → Custom (OpenAI-compatible) ayarlarını yapın.
https://api.kunavo.com/v1'i Custom Endpoint alanına, anahtarı da Custom API Key alanına yapıştırın.
Connect'e basın. Yeşil durum göstergesi ve dolu bir Available Models açılır listesi, bağlantının başarılı olduğu anlamına gelir.
Açılır listeden bir model id'si seçip sohbete başlayın. Daha sonra model değiştirirken yeniden bağlanmanız gerekmez.

Bu ekrana ilişkin SillyTavern'ın kendi başvuru kaynağı Chat Completions API bağlantıları sayfasıdır.

Arayüzde hata ayıklamadan önce doğrulayın

Tek bir istek, sorunun uç noktada, anahtarda mı yoksa SillyTavern'da mı olduğunu ortaya çıkarır. Bu istek JSON biçiminde bir model id'si listesi döndürürse aynı URL ve anahtar açılır listeyi doldurur.

# Confirms the key and the endpoint before you touch SillyTavern.
# A JSON list of model ids means the same URL will populate the dropdown.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Hangi modelleri seçmeli?

Kunavo'daki her metin modeline aynı açılır listeden erişebilirsiniz. Listenin tamamı modeller sayfasındadır ve GET /v1/models isteğiyle canlı olarak alınır. Ücretler 1M belirteç başına USD cinsindendir; girdi/çıktı.

Model kimliği	Kunavo giriş / çıkış	Kullanım alanı
`claude-haiku-4-5`	$0.70 / $3.50	En ucuz Claude — tur başına maliyetin en önemli olduğu uzun oturumlar için
`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ı
`claude-fable-5`	$7.00 / $35.00	1M belirteçlik bağlam penceresiyle en ileri düzey akıl yürütme — sohbet geçmişinin kendisinin sorun olduğu durumlar için

Uzun bir SillyTavern oturumunda önce bağlam uzunluğu kısıtlayıcı olur: her turda tüm geçmiş yeniden gönderildiğinden, belirteç harcaması sabit kalmak yerine konuşma uzadıkça artar. Kunavo, aylık ücret olmaksızın ön ödemeli bakiyeden belirteç başına ücret alır; bu nedenle kullanılmayan bir ay hiçbir ücrete yol açmaz. Ayrıntılar için faturalandırma sayfasına bakın; yinelenen bağlamda en çok fark yaratan etken ise istem önbelleğe alma özelliğidir.

Sorun giderme

Belirti	Neden	Çözüm
Bağlantı başarısız, model listesi boş kalıyor	Custom Endpoint'te `/v1` eksik	`https://api.kunavo.com/v1`'i kullanın. Yukarıdaki curl komutuyla doğrulayın.
401 / geçersiz anahtar	Anahtar başına veya sonuna boşluk eklenerek yapıştırılmış ya da iptal edilmiş	`/app/keys`'den yeniden kopyalayın; 401 ve 403 sayfasına bakın
Yanıtlar akış halinde değil, tümü birden geliyor	Bağlantının önündeki bir proxy sunucu tarafından gönderilen olayları arabelleğe alıyor	Uç nokta tarafında akış desteklenir — akış hataları
Model id'si reddedildi	Bu uç nokta bu id'yi sunmuyor	Açılır listeden seçin veya model_not_found sayfasına bakın
Hatalar yalnızca uzun sohbetlerde oluşuyor	Geçmiş, modelin bağlam penceresini aşmış	Geçmişi kısaltın veya daha uzun bağlamlı bir modele geçin — context_length_exceeded

Açıkça belirtilmesi gereken iki nokta

İlişkisi yoktur

SillyTavern bağımsız, açık kaynaklı bir projedir ve Kunavo ile ilişkisi yoktur. Bu sayfada, SillyTavern'ın OpenAI uyumlu rastgele uç noktaları desteklemesi sayesinde çalışan bir yapılandırma açıklanmaktadır; taraflardan hiçbiri için burada özel bir ayar söz konusu değildir.

İçerik politikası geçerliliğini korur

Kunavo üzerinden gönderilen istekler üst akış sağlayıcılarına ulaşır ve her sağlayıcı kendisine gönderilen içerik için kendi kullanım politikasını uygular. Bir ağ geçidi bu sınırları kaldırmaz; aksini söyleyen her sayfa size bir şey satmaya çalışıyordur. Kunavo'nun kendi koşulları için kabul edilebilir kullanım politikasına bakın.

Sık sorulan sorular

SillyTavern'ı özel bir API uç noktasına nasıl bağlarım?

SillyTavern'da API Connections sekmesini (fiş simgesi) açın, API ayarını Chat Completion, Chat Completion Source ayarını da Custom (OpenAI-compatible) olarak belirleyin. Ağ geçidinin OpenAI uyumlu temel URL'sini Custom Endpoint alanına girin — Kunavo için bu https://api.kunavo.com/v1 değeridir — anahtarı Custom API Key alanına yazıp Connect'e basın. SillyTavern daha sonra bu uç noktaya GET /v1/models isteği gönderir ve açılır model listesini yanıttan doldurur.

SillyTavern, OpenAI uyumlu bir uç nokta üzerinden Claude modelleriyle çalışır mı?

Evet. SillyTavern'ın Custom (OpenAI-compatible) kaynağı yalnızca POST /v1/chat/completions isteğini uygulayan bir uç nokta gerektirir. Bu nedenle bu biçimde sunulan Claude modelleri, SillyTavern'ın ayrı Anthropic kaynağını kullanmadan çalışır. Kunavo'da Claude ve GPT model id'lerinin tümü tek bir anahtarın arkasındaki aynı açılır listede görünür; aralarında geçiş yapmak için yeniden bağlanmanız gerekmez.

Özel uç noktayla SillyTavern'da akış yanıtları çalışır mı?

Uç nokta /v1/chat/completions üzerinde sunucu tarafından gönderilen olayları uyguluyorsa akış yanıtları çalışır; Kunavo bunu destekler. Yanıtlar yalnızca tam bir blok olarak geliyorsa, bunun olağan nedeni uç noktanın kendisi değil, bağlantının önündeki bir proxy'nin akışı arabelleğe almasıdır.

Bağlandıktan sonra SillyTavern'ın model listesi neden boş?

SillyTavern'da boş bir model açılır listesi, GET /v1/models çağrısının başarısız olduğu anlamına gelir; sorun SillyTavern'da değil, uç noktada veya anahtardadır. En sık rastlanan iki neden, temel URL'nin /v1 sonekinin eksik olması ve uç nokta için geçerli olmayan bir anahtar kullanılmasıdır. Aynı anahtarla /v1/models adresine curl çalıştırmak hatayı SillyTavern dışında da yeniden üretir ve iki nedenden hangisinin söz konusu olduğunu gösterir.