TR ▾
API anahtarı al

Janitor AI için OpenRouter Alternatifi: Kurulum Kılavuzu

Özel OpenAI uyumlu API'yi kabul eden karakter sohbeti ön uçları, bu uç noktaya üç değerle bağlanabilir: bir URL, bir anahtar ve bir model adı. İşte tam kurulum, başlangıç sistem istemi ve planlamanız için dikkate almanız gereken sınırlar.

güncellendi

Parlayan sohbet balonları ve maskelerin, küçük bir sunucu küpüne kablo ile bağlandığı sahne

Temel noktalar

  1. Temel URL'yi https://api.openrouterapi.cc/v1, anahtarınızı ve model kimliğini "uncensored" olarak girin.
  2. Önce curl ile test edin, böylece sorunun anahtar mı yoksa istemci mi olduğunu bilirsiniz.
  3. 30.000 token'lık bir rol yapma geçmişi, yanıt başına yaklaşık 0,0047 $ tutarındadır; 100 yanıt yaklaşık 0,47 $ eder.
  4. Model yalnızca metin destekler ve 100.000 token'lık bir bağlam penceresine sahiptir.

Deneme kredisiyle başlayın

E-posta ve parola, anahtar hemen ekranda.

API anahtarı al

Girmeniz gerekenler

Bir OpenRouter alternatifi veya benzeri bir karakter sohbet uygulaması kullanmak istiyorsanız, kurulum herhangi bir OpenAI uyumlu sağlayıcı için olduğu gibidir. İstemcinizde özel veya proxy API eklediğiniz yeri bulun. Farklı uygulamalar bunu farklı şekilde adlandırır: "proxy", "özel OpenAI uç noktası", "API URL". Altındaki alanlar her zaman aynı üç alandır.

AlanDeğer
API URL / temel URLhttps://api.openrouterapi.cc/v1
API anahtarıHesabınızdaki anahtar, Authorization: Bearer olarak gönderilir.
Model adıuncensored

Bazı istemciler tam uç noktayı temel uç noktadan daha çok tercih eder. Temel URL'nin kaydedilmesi hata veya 404 hatası verirse, https://api.openrouterapi.cc/v1/chat/completions adresini deneyin. Desteklenen iki yöntem POST /v1/chat/completions ve GET /v1/models şeklindedir; bu nedenle modelleri listeleyen bir istemci ikincisini çağırır ve uncensored sonucunu görür.

Henüz bir anahtarınız yoksa, Google veya e-posta ve şifre ile kaydolun ve API anahtarı talimatlarını izleyin. Yeni hesaplar tek tıkla 0,50 $ deneme kredisi talep edebilir; bu ilk test oturumu için yeterlidir.

Uygulamayı suçlamadan önce bağlantıyı test edin

Rol yapma arayüzleri ham hata metnini gizler. Önce bir terminalden tek bir istek çalıştırın, böylece anahtarın ve modelin çalıştığını bilin. Yer tutucuyu kendi anahtarınızla değiştirin.

curl https://api.openrouterapi.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship engineer."},
      {"role": "user", "content": "The reactor is humming wrong again."}
    ],
    "temperature": 0.9,
    "max_tokens": 200
  }'

Bu bir yanıt döndürürse, uç nokta ve anahtar iyidir ve herhangi bir sorun uygulamanın ayarlarındadır. Başarısız olursa, hata gövdesi nedenini söyler. X-Request-Id yanıt başlığından istek kimliğini kaydedin; bu, destek ile yazışırken yardımcı olur.

Bir başlangıç sistem istemi

Bir arayüzdeki karakter kartı genellikle sistem mesajı haline gelir. Uygulamanız ne yaparsa yapsın, model aşağıdaki metne benzer bir şey alır. Model, yasal yetişkin kullanım için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır; bu nedenle istemin modelle tartışması gerekmez. Ses, sınırlar ve biçim konusunda net olmalıdır.

Sen, Callaway kargo gemisinde baş mühendis Mara Voss'sun.

Ses: kuru, pratik, stres altında hızlı espri yapan.

Üçüncü şahıs geçmiş zamanla, 2 ila 4 kısa paragraf halinde yazın.

Kullanıcının karakteri adına konuşmayın veya davranmayın.

Sürekliliği koruyun: yaralanmaları, tamiratları ve kimin neyi bildiğini takip edin.

Hikayede kalın. Tüm karakterler yetişkindir.

İki alışkanlık uzun oturumları iyileştirir. Birincisi, sistem isteminin her adımda yeniden gönderildiği için kısa tutun. İkincisi, katı kuralları istemin ortasına değil sonuna koyun; böylece sohbet geçmişi büyüdüğünde öne çıkmaya devam ederler. Uygulamanız "yazar notu" veya en son mesaja yakın eklenen bir hatırlatma eklemenize izin veriyorsa, stil kuralları için bunu kullanın.

Bu hizmette ve isteminizde sabit bir kural vardır: reşit olmayanların dahil olduğu cinsel içerik yok. Bunu karakter kartına yazmak kendi kartlarınızı da temiz tutar.

Genellikle çalışan ayarlar

Bunlar başlangıç noktalarıdır, garanti değildir. Bir seferde birini değiştirin ve birkaç yanıtı karşılaştırın.

  • Canlı diyaloglar için sıcaklık 0,8 ile 1,0 arası. Karakter kayarsa veya çelişirse, 0,6 civarına düşürün.
  • İstemciniz erişim sağlıyorsa top_p 0,9 ile 0,95 arası. Bu değer doğrudan iletilir.
  • Yanıtlar tekrarlamaya başladığında frekans ve varlık cezası 0,2 ile 0,5 arası. Büyük değerler metni tuhaf hale getirir, bu nedenle düşük tutun.
  • max_tokens isteğe bağlıdır. Paragraf uzunluğunda yanıtlar ve denemeler istiyorsanız 300 ile 600 arasını ayarlayın.
  • Akış açık. Yanıt yazılırken görünür ve son parça kullanım bilgisi taşır; böylece istemciniz token sayılarını gösterebilir.
  • seed doğrudan iletilir; bu, aynı rolde iki istem versiyonunu karşılaştırmak istediğinizde kullanışlıdır.

Akışın bilmeniz gereken bir yan etkisi vardır: akışlı bir istek, akış bitene kadar eşzamanlılık slotunu tutar. Tam anahtar aynı anda 8 istek ve dakika başına 300 istek izin verir. Deneme anahtarı aynı anda 2 ve dakika başına 60 istek izin verir.

Bağlam, bellek ve uzun sohbetlerin maliyeti

Bağlam penceresi 100.000 token'dır; istem ve tamamlama birlikte. Bu çok fazla hikaye demektir: on binlerce kelimelik geçmiş sığabilir. Maliyet buna göre artar, çünkü her seferinde tüm geçmiş gönderilir. İşte uzun bir oturum için bir örnek.

Geçmişin 30.000 token'a ulaştığını ve yanıtın 300 token olduğunu varsayalım. Girdi: 30.000 x 0,15 $ / 1M = 0,0045 $. Çıktı: 300 x 0,50 $ / 1M = 0,00015 $. Bir yanıtın maliyeti 0,00465 $'dır. Bu boyuttaki yüz yanıt 0,465 $ eder; yani yaklaşık 47 sent.

Daha kısa bir geçmiş daha ucuzdur ve genellikle daha iyidir. Modeller çok uzun istemlerin ortasına daha az dikkat eder; bu nedenle eski olayların temiz bir özeti ile son on iki mesaj, 30.000 ham token'dan daha tutarlı okunabilir. Birçok arayüzde özet veya "bellek" özelliği vardır. Sohbet birkaç bin token'a ulaştığında bunu kullanın.

Fiyatlar 1M giriş için $0,15 ve 1M çıktı için $0,50'dir. Başarısız veya reddedilen istekler için ücret alınmaz ve kredi hiç sona ermez. Bakiye yükleme tutarları, bonuslar ve kart ile kripto dahil ödeme yöntemleri için fiyatlandırma sayfasına bakın.

Karakterleri haftalarca tutarlı tutmak

Uzun süreli karakterler kayar. Çözüm büyük ölçüde belgelemektir ve iyi yapılırsa token maliyeti çok azdır.

Değişmeyen sabit bir gerçekler bloğu tutun: ad, kişilik, konuşma alışkanlıkları, ilişkiler. Elle düzenlediğiniz ve zaman zaman güncellediğiniz ikinci bir blok tutun: mevcut durum, açık hikaye iplikleri, verilen sözler. Her ikisini de sistem istemine veya istemcinizin bellek alanına yapıştırın ve her birini yaklaşık 500 token altında tutun. Birlikte bunlar en fazla 1.000 token eder; bu da girdi oranında yanıt başına 0,00015 $ tutarındadır.

Ardından canlı sohbete yalnızca son alışverişi taşıyın. Bir sahne bittiğinde, ikinci bloğa iki veya üç cümlelik özet yazın ve eski mesajları temizleyin. Karakterleriniz keskin kalır, yanıtlar okuması daha hızlı olur ve yanıt başına maliyet her oturumda artmak yerine yaklaşık bir sentin onda birinde kalır.

Bir sohbette birden fazla karakter çalıştırıyorsanız, kimin konuştuğunu ve ne zaman olduğunu belirtin. "Kullanıcı başka bir karakter istemedikçe yalnızca Mara'nın satırlarını yaz" gibi bir satır, modelin herkesi aynı anda anlatmasını önler; bu da yanıtları kısa ve ucuz tutar.

429 hataları ve tuhaf yanıtlar için sorun giderme

Rol yapma uygulamaları hız limitlerini yanlışlıkla tetiklemeye çok yatkındır: iki tarayıcı sekmesi, iki kez basılan "yenile" butonu, aynı anda birkaç karakterin yanıt verdiği bir grup sohbet. API, HTTP 429 yanıtı ve bu nedenlerden biriyle yanıt verir.

  1. Hata kodu concurrency. Uçta olan istek sayısı anahtarınızın izin verdiği miktardan fazla. Fazla sekmeleri kapatın, akışın bitmesini bekleyin veya karakterlerin eşzamanlı yanıt vermesini kapatın. Akışın sona erene kadar slotu işgal ettiğini unutmayın.
  2. Hata kodu rate_limited. Bir dakika içinde çok fazla istek gönderdiniz. Hızı düşürün; bir kişinin yazma hızı nadiren dakikada 300'e ulaşır, ancak otomatik bir kaydırma döngüsü deneme anahtarında dakikada 60 istek yapabilir.
  3. Retry-After: 5 başlığıyla 429. Hizmet geçici olarak aşırı yüklü. Beş saniye bekleyin ve tekrar gönderin.

Yanıtlar kesiliyorsa, istemcinizdeki max_tokens ayarını kontrol edin. Karakter sizin için konuşuyorsa, sistem istemindeki kuralı güçlendirin ve sıcaklığı düşürün. Uygulama modelin bulunamadığını söylüyorsa, model alanının tam olarak uncensored olarak, küçük harfle yazıldığından emin olun.

Nerede işe yarar ve nerede işe yaramaz

İstemciniz kendi uç noktasını seçmenize olanak tanıyor ve tek bir model için düz token başına fiyat istiyorsanız, bu bir değiştirici olarak çalışır. Sohbet sırasında birden fazla model arasında geçiş yapmak istiyorsanız, bir yönlendiriciyi değiştirmez. Bağımsız bir sağlayıcıdan tek bir model alırsınız; herhangi bir model satıcısının resmi API'si değildir.

Model yalnızca metin destekler. Karakter sanatı, ses veya video üretmez ve embeddings mevcut değildir. İstemlerinizden bunlara bağlı olanlar başka bir hizmet gerektirir. İstemler eğitim için kullanılmaz ve tam hızlı başlangıç dokümantasyonda yer alır.

Sorular ve cevaplar

Janitor AI tarzı ayarlarda hangi model adını yazmalıyım?

Model alanına küçük harfle uncensored yazın. URL olarak https://api.openrouterapi.cc/v1'i ve kendi anahtarınızı kullanın.

Sohbet sırasında neden 429 hatası alıyorum?

Ya aynı anda çok fazla istek açık (eşzamanlılık) ya da dakikada çok fazla istek (hız limiti). Fazla sekmeleri kapatın ve akışların bitmesini bekleyin; bir deneme anahtarı aynı anda 2 isteye izin verir.

Model karakterlerim için resim üretebilir mi?

Hayır. Bu yalnızca bir metin modelidir; resim, ses veya video üretimi yoktur.

Bir rol yapma oturumu ne kadar tutar?

30.000 token'lık geçmiş ve 300 token'lık yanıtlar ile her yanıt yaklaşık 0,0047 $ tutarındadır, bu nedenle 100 yanıt yaklaşık 47 sent eder.

Anahtarınız tek bir adımda ulaşılabilir

Bir hesap oluşturun, anahtarı kopyalayın, base URL'yi değiştirin. Kurulum bu kadar.

API anahtarı al