SillyTavern API kurulumu: temel URL, API anahtarı ve model listesi

Hızlı yanıt: önemli olan beş ayar

API Connections panelini açın (fiş simgesi) ve tam olarak şunu ayarlayın: API = Chat Completion. Chat Completion Source = Custom (OpenAI uyumlu). Custom Endpoint (Base URL) = https://api.apisrouter.com/v1. Custom API Key = sk-... anahtarınız. Connect'e tıklayın, yeşil ışığı bekleyin ve açılır listeden bir model seçin, örneğin deepseek-v4-flash. En yaygın hata, tam yolu yapıştırmaktır. SillyTavern girdiğiniz her şeye /chat/completions ekler, bu yüzden URL /v1'de durmalıdır. https://api.apisrouter.com/v1/chat/completions yapıştırırsanız, SillyTavern /v1/chat/completions/chat/completions isteği gönderir ve bağlantı 404 hatasıyla başarısız olur. Bu, proxy yapılandırmasında tam completions URL'sini isteyen JanitorAI'nin tam tersidir. Aynı sağlayıcı, farklı alan kuralları.

SillyTavern API URL'si neden /v1'de bitiyor

Her OpenAI uyumlu API, bir temel URL artı sabit rotalar kümesidir. GET /v1/models, anahtarınızın kullanabileceği model ID'lerinin listesini döndürür. POST /v1/chat/completions gerçek sohbet isteğini çalıştırır. SillyTavern bu rotaları bilir ve onları kendisi oluşturur, bu yüzden sizden yalnızca temel URL'yi ister. Connect'e tıkladığınızda, anahtarınızla /v1/models'i çağırır ve model açılır listesini doldurmak için yanıtı kullanır. Boş bir açılır liste neredeyse her zaman bu çağrının başarısız olduğu anlamına gelir. Doğru API modunu da seçmeniz gerekir. Chat Completion, system, user ve assistant rolleriyle yapılandırılmış mesajlar gönderir; bu, barındırılan her OpenAI uyumlu sağlayıcının beklediği şeydir. Text Completion tek bir ham prompt dizesi gönderir ve esas olarak KoboldCpp ve text-generation-webui gibi yerel arka uçlar için vardır. Barındırılan herhangi bir API anahtarı için Chat Completion kullanın. Barındırılan bir sohbet endpoint'ine karşı Text Completion seçerseniz hata alırsınız veya biçimlendirme bozulur, üstelik o modda gösterilen birçok sampler zaten gönderilmez.

Adım adım kurulum

Connect'ten sonra açılır liste boş kalırsa, sırayla üç şeyi yeniden kontrol edin: URL'nin sonda fazladan yol veya boşluk olmadan /v1'de bitip bitmediği, anahtarın tırnak veya boşluk olmadan yapıştırılıp yapıştırılmadığı ve kaynağın düz OpenAI değil Custom (OpenAI uyumlu) olup olmadığı. Düz OpenAI kaynağı bazı sürümlerde özel URL'nizi yok sayar ve anahtarınızın geçersiz olduğu api.openai.com ile konuşur.

• Bir anahtar edinin. APIsRouter'de hesap formu yoktur: /topup adresinden ödeme yapın, anahtar size e-posta ile gönderilir. OpenAI uyumlu herhangi bir anahtar bu adımlarda aynı şekilde çalışır.
• SillyTavern'de API Connections'ı açmak için fiş simgesine tıklayın.
• API'yi Chat Completion olarak ayarlayın.
• Chat Completion Source'u Custom (OpenAI uyumlu) olarak ayarlayın.
• Custom Endpoint (Base URL) alanına, /v1'den sonra hiçbir şey olmadan https://api.apisrouter.com/v1 girin.
• Anahtarınızı Custom API Key alanına yapıştırın.
• Connect'e tıklayın. Durum noktası yeşile döner ve Available Models açılır listesi /v1/models'ten dolar.
• Bir model seçin, bir karakter kartı açın ve kısa bir test mesajı gönderin.

Bağlantıyı SillyTavern dışında doğrulayın

Bir şey başarısız olduğunda, SillyTavern'i suçlamadan önce endpoint'i doğrudan test edin. Bu curl çağrısı, Connect düğmesinin tam olarak yaptığı şeydir. Model ID'lerinden oluşan bir JSON dizisi döndürürse, anahtarınız ve URL'niz sorunsuzdur ve sorun SillyTavern alanlarındadır. Model listesi çalışıyor ama sohbetler başarısız oluyorsa, aynı temel URL ile Python'dan gerçek bir tamamlama çalıştırın. Buradaki başarılı bir yanıt tüm zinciri kanıtlar ve geri aldığınız herhangi bir hata mesajı, SillyTavern'in genel hatası yerine sağlayıcının gerçek hatasıdır.

curl https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer sk-your-key"

Sampler ve preset temelleri

Chat Completion kaynakları küçük bir sampler kümesi sunar: temperature, top P, frequency penalty ve presence penalty, artı yanıt uzunluğu ve context boyutu. Okumuş olabileceğiniz daha gelişmiş sampler'lar (min P, mirostat, dynamic temperature) Text Completion arka uçlarına aittir ve barındırılan sohbet API'lerine basitçe gönderilmez, bu yüzden onları burada aramayın. SillyTavern'deki preset'ler iki şeyi bir araya getirir: sampler değerleri ve Prompt Manager'ın karakter kartınızdan, persona'nızdan ve lorebook'unuzdan derlediği prompt yapısı. Yerleşik Default preset makul bir başlangıç noktasıdır. Bir seferde tek bir değeri değiştirin ve gerçekte ne yaptığını görmek için aynı sahneyi yeniden oluşturun. Context boyutu dikkat gerektirir: SillyTavern context penceresini sohbet geçmişiyle doldurur, bu yüzden daha büyük bir context her turda daha fazla prompt token'ı gönderilmesi demektir; bu hem hafızayı iyileştirir hem de mesaj başına maliyeti aynı anda artırır.

SillyTavern için önerilen modeller

Model seçimi, sampler ayarından daha önemlidir. Yaklaşık raporlara göre topluluk fikir birliği, fiyat için DeepSeek V4 ailesini birinci sıraya koyuyor: deepseek-v4-flash, uzun sohbetler için varsayılan öneridir ve deepseek-v4-pro, karmaşık kartları ve grup sohbetlerini daha iyi bir arada tutar. GLM-5, Kimi K2.6 ve MiMo, farklı düzyazı seslerine sahip sağlam değer seçenekleridir; bir sohbet tekdüzeleşmeye başladığında rotasyona sokmaya değer. Grok dikkat çekicidir çünkü xAI'nin yayınlanmış politikası kurgusal ortamlarda olgun temalara açıkça izin verir, bu da daha karanlık hikaye çizgileri için önemlidir. Claude bu listedeki her şeyden en iyi düzyazıyı yazar ama Anthropic'in politikası açık içeriği yasaklar, bu yüzden Claude'u SFW yaratıcı yazım ve edebi tarz sahneler için tercih olarak ele alın. İki pratik not. Birincisi, SillyTavern yetişkinlere yönelik bir yazılımdır ve buradaki her model, ön yüzünüz ne olursa olsun kendi sağlayıcısının içerik politikasını uygular, bu yüzden kartları ve sahneleri bu kurallar içinde tutun. İkincisi, açılır liste /v1/models'ten canlı olarak dolduğu için, sohbet ortasında modelleri değiştirebilir ve aynı mesaja verilen yanıtları karşılaştırabilirsiniz; bu, kendi favorinizi bulmanın en hızlı yoludur.

SillyTavern sohbetleri gerçekte ne kadar tutuyor

Barındırılan modeller token başına fatura keser ve rol yapma input-ağırlıklıdır: her tur karakter kartını artı son geçmişi yeniden gönderir. 8.000 prompt token'ı gönderen ve 350 token'lık bir yanıt alan bir tur, deepseek-v4-flash'te yaklaşık bir sentin onda biri tutar, bu yüzden birkaç dolar aylarca sıradan sohbet için yeter. Aynı tur claude-opus-4-7'de yaklaşık 25 kat daha fazla tutar, bu yüzden çoğu kişi ucuz bir günlük sürücü çalıştırır ve premium modelleri önemsedikleri sahneler için saklar. Tek bir gateway anahtarı bu tablonun tamamını kapsar. APIsRouter, kullandıkça öde faturalandırmalı ve abonelik gerektirmeyen OpenAI uyumlu bir gateway'dir: hesap oluşturmadan /topup adresinden ödeme yaparsınız, anahtar e-posta ile gelir, ilk yüklemeniz bakiyenize eşleşen +%100 ekler, küresel modeller resmi oranların %20 altında fiyatlandırılır ve Çin modelleri resmi fiyatlarının altında kalır.

Sık sorulan sorular