TR ▾
API anahtarını al

SillyTavern API Ayarları: OpenAI Uyumlu Bağlantı Adımları

sillytavern api ayarlarında sıkça karıştırılan bağlantı noktası, anahtar, model adı ve bağlam penceresi değerlerini doğrulama komutlarıyla açıklıyoruz.

Güncelleme tarihi:

Önemli Noktalar

  • Bağlantı türü olarak Chat Completion (Özel/OpenAI uyumlu) seçin
  • URL: https://api.mukenetsuapi.com/v1, model adı: uncensored
  • Bağlam 100.000'e kadar mümkün olsa da, maliyet ve hız nedeniyle daraltmak daha gerçekçidir.
  • 401 anahtar, 404 URL, 429 ise eşzamanlılık veya hız limiti ihlali anlamına gelir
SillyTavern API bağlantısını temsil eden, sahne maskesi ve sunucu fişinin parlak kablolarla birleştirildiği görsel

Öncelikle gerekli 3 öğeyi hazırlayın

SillyTavern API ayarları basittir; çoğu hata yanlış değer girişinden kaynaklanır. Aşağıdaki 3 öğeyi hazırlayın.

  • API anahtarı: Anahtar oluşturma sayfası üzerinden alın. Kayıt sonrası $0,50 ön ödemeli kredi tek tıkla alınır.
  • Base URL: https://api.mukenetsuapi.com/v1
  • Model adı: uncensored

SillyTavern, OpenAI uyumlu bir uç nokta ekleyebilen bir ön uçtur. Bu API OpenAI uyumlu olduğundan, resmi OpenAI'yi seçmenize gerek yoktur; özel bir uç nokta olarak kaydedebilirsiniz.

Bağlantı adımları

Menü metinleri sürüme göre değişebilir. Genel akışı yazıyoruz. Farklılık varsa SillyTavern dokümanlarına da bakın.

  1. Üstteki "API Connections" (fiş simgesi) menüsünü açın.
  2. API türü olarak "Chat Completion" seçin.
  3. Kaynak listesinden OpenAI uyumlu özel bağlantıyı (Custom) seçin.
  4. Uç nokta URL'sine https://api.mukenetsuapi.com/v1 girin. Sonuna /chat/completions eklemeyin.
  5. API anahtarı alanına oluşturduğunuz anahtarı yapıştırın. Anahtarın başında veya sonunda boşluk kalmadığından emin olun.
  6. Model adını uncensored olarak ayarlayın. Listeden seçin veya manuel olarak yazın.
  7. Bağlan butonuna basın ve başarı mesajı görüp görmediğinizi kontrol edin.

Bağlantı kurmadan önce, terminalde anahtarınızın ve URL'nizin doğru olduğunu doğrulayın; bu, sorunları ayırmanızı kolaylaştırır.

curl https://api.mukenetsuapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "こんにちは"}], "max_tokens": 50}'

Yanıt alırsanız anahtar, URL ve model doğrudur. Yanıt alamazsanız SillyTavern girişlerini kontrol edin.

Bağlam penceresi ve yanıt uzunluğunu belirleyin

Bu API, istem ve çıktıyı birlikte 100.000 tokena kadar destekler. Ancak SillyTavern'de bağlam penceresini maksimuma çıkarmayın. Her seferinde karakter ayarı, dünya bilgisi ve geçmiş gönderildiği için yüksek değerler maliyeti artırır.

Maliyet hesaplama örneği

Bağlam penceresi 16.000 token ve yanıt 300 token ise mesaj başına maliyet:

  • Girdi: 16.000 ÷ 1.000.000 × $0,15 = $0,0024
  • Çıktı: 300 ÷ 1.000.000 × $0,50 = $0,00015
  • Toplam: $0,00255

100 mesaj için $0,255'tir. Bağlamı 8.000'e yarıya indirirseniz, girdi tarafı yaklaşık yarıya iner. Birim fiyat detayları için fiyatlandırma sayfası'ni ziyaret edin.

Tahmini değerler

Uzun hikayeler veya çok kişili sahneler değilse, önce 8.000 ile 16.000 arasında başlamak ve karakter geçmiş olayları unutmaya başladığında artırmak gerçekçi bir sıradır. Yanıtın maksimum uzunluğu, tek bir yanıt olarak okumak istediğiniz uzunluğa göre ayarlanmalıdır. max_tokens isteğe bağlıdır ancak çok uzun yanıtlardan kaçınmak istiyorsanız, SillyTavern tarafında bir üst sınır belirlemeniz güven vericidir.

Örnekleme ayarlarının mantığı

temperature, top_p, stop, seed ve çeşitli ceza parametreleri API'ye doğrudan iletilir. SillyTavern ön ayarlarıyla ayarlanabilir.

  • Aynı ifade tekrar ediyor: frequency veya presence cezalarını biraz artırın.
  • Yanıt dağınık: temperature değerini düşürün.
  • Tekdüze: temperature değerini biraz artırın.
  • Karşılaştırmak istediğiniz: seed'i sabitleyin ve 1'er 1'er değer değiştirin.

Ön ayar öğe adları SillyTavern sürümüne göre farklılık gösterir. Ayarlar yansımıyorsa, kullandığınız bağlantı yönteminin bu öğeyi destekleyip desteklemediğini veya SillyTavern belgelerine bakarak doğrulayın.

Yaygın hatalar ve çözümler

BelirtilerOlası nedenlerÇözüm
401Anahtar yanlış veya boşluk içeriyorAnahtarı tekrar yapıştırın ve curl ile aynı anahtarı deneyin.
404URL yanlışSonunun /v1 ile bittiğinden emin olun.
Model bulunamadıModel adının yazılışıuncensored olarak küçük harfle girin.
429 (concurrency)Aynı anda çok fazla eşzamanlı istekKaydırma tuşlarına art arda basmayı veya grup sohbetlerinde eşzamanlı üretimi azaltın.
429 (rate_limited)Dakika başı istek sayısı aşıldıBiraz bekleyin.
429 (Retry-After: 5 ile)Geçici yoğunluk5 saniye bekleyip yeniden deneyin.

Tam anahtarın limiti eşzamanlı 8, dakikada 300; deneme kredisi eşzamanlı 2, dakikada 60'tır. Akış yanıtı, bitene kadar eşzamanlı bağlantı kotasından 1 birim kullanır. Deneme kredisiyle grup sohbeti çalıştırırsanız, kota hemen dolar.

Bakiyenin yeterli olup olmadığını aşağıdaki komutla kontrol edebilirsiniz.

curl https://api.mukenetsuapi.com/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

Yanıt başlıklarından X-Balance-USD üzerinden de okunabilir. Model listesini görüntülemek için GET /v1/models kullanılır.

curl https://api.mukenetsuapi.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Kullanım notları

Bu API yalnızca metin içindir. SillyTavern'da görsel oluşturma veya ses özelliklerini kullanmak için başka bir hizmete ihtiyacınız vardır. İçerikler; yasal yetişkin kullanım kapsamında romanlar, rol yapma ve companion uygulama gibi kurgular için tasarlanmıştır. Reşit olmayanların dahil olduğu cinsel içerikler tüm ayarlarda üretilmez. İstemler model eğitimi için kullanılmaz.

Daha ayrıntılı parametreler belgeler'de yer alır; ödeme USDT (TRC20) veya USDC (Base) ile $20 ile $500 arasında tam sayı tutarlarda yapılır.

Diğer kılavuzlar

Sık sorulan sorular

SillyTavern'de hangi model adı kullanılır?

uncensored. Küçük harfle, olduğu gibi girin.

URL'nin sonuna /chat/completions eklenmeli mi?

Gerekli değil. Base URL /v1 ile bitmelidir; geri kalan yol, uygulama tarafından eklenir.

Deneme anahtarı yeterli mi?

Bağlantı doğrulaması ve kısa sohbetler için yeterlidir. Ancak deneme anahtarı eşzamanlı 2 ve dakika başı 60 ile sınırlıdır ve geçerlilik süresi 7 gündür; grup sohbeti kullanıyorsanız normal anahtara bakiye yükleyin.

Görsel de oluşturabilir miyim?

Hayır. Bu API yalnızca metin içindir; görsel, ses ve video oluşturma desteklenmez.

Bağlam penceresi kaç token olmalı?

Maksimum 100.000 token'dır, ancak 8.000 ile 16.000 arasında başlamak daha gerçekçidir. Daha büyük değerler her girdi için daha fazla token ve daha yüksek maliyet anlamına gelir.

API anahtarı tek bir form ile elde edilir

Hesap oluşturma, anahtarın kopyalanması ve Base URL'nin değiştirilmesi. Bu kadarıyla tüm kurulum tamamlanır.

API anahtarı al