Janitor AI proxy kurulumu: URL formatı, modeller ve 429 çözümleri

Kısa cevap: JanitorAI'nin istediği üç alan

JanitorAI'nin proxy yapılandırması tam olarak üç değer alır: bir proxy URL'si, bir model adı ve bir API anahtarı. Proxy URL'si bir base URL değil, tam chat completions endpoint'i olmalıdır. Sağlayıcınız size /v1'de biten bir base URL veriyorsa, JanitorAI'ye yapıştırmadan önce /chat/completions ekleyin. Bu tek detay, geri kalan her şeyden daha fazla başarısız kuruluma neden olur. Model ID'sini sağlayıcının yazdığı şekilde, küçük harf ve tireler dahil, tam olarak girin, ardından kaydedin ve kısa bir test mesajı gönderin. Bir yanıt gelirse işiniz bitti. Bunun yerine bir hata kodu alırsanız, aşağıdaki hata tablosuna geçin. Her yaygın kodun belirli bir nedeni ve belirli bir çözümü vardır.

Proxy URL:  https://api.apisrouter.com/v1/chat/completions
Model:      deepseek-v4-flash
API Key:    sk-...   (paste exactly, no quotes, no trailing spaces)

"Proxy" JanitorAI topluluğunda ne anlama geliyor

Bu kelime yanıltıcıdır. JanitorAI argosunda proxy, bir ağ proxy'si veya VPN değildir. Sitenin sohbet isteklerinizi varsayılan backend'i yerine gönderdiği, herhangi bir OpenAI uyumlu API endpoint'idir. Topluluk bu terimi yıllar önce, insanlar sağlayıcı API'lerinin ters proxy'leri üzerinden sohbetleri yönlendirmeye başladığında benimsedi ve bugün çoğu kurulum doğrudan bir sağlayıcı veya gateway ile konuşsa bile isim yerleşti. İnsanlar üç nedenle proxy çalıştırır. Birincisi, model seçimi: sitenin varsayılan olarak sunduğu her ne ise onu kabul etmek yerine karakterlerinizi hangi LLM'in yazacağını tam olarak seçersiniz. İkincisi, kalite: DeepSeek V4 veya Claude gibi modeller, ücretsiz yerleşik bir katmandan daha uzun ve daha tutarlı sahneler yazar. Üçüncüsü, maliyet kontrolü: token başına ödeme yapan bir anahtarla, tam olarak kullanmayacağınız bir abonelik için ödeme yapmak yerine her sohbetin size tam olarak neye mal olduğunu görürsünüz. Toplulukta paylaşıldığını göreceğiniz üç tür endpoint vardır. Resmi sağlayıcı API'leri (OpenAI, Anthropic, xAI, DeepSeek) her satıcıyla bir hesap gerektirir. Gateway'ler birçok modeli tek bir OpenAI uyumlu URL ve tek bir anahtarın arkasında toplar. Topluluk "ücretsiz proxy'leri", başka birinin ödediği paylaşılan anahtarlardır, bu yüzden kararsız ve ağır rate limitlidir. Açıkça söylenmesi gereken bir şey daha var: hangi endpoint'i kullanırsanız kullanın, upstream model sağlayıcısının içerik politikası her yanıta uygulanmaya devam eder ve JanitorAI'nin kendi şartları, yalnızca yetişkinlere yönelik şartı dahil, platformu yönetmeye devam eder. Bir model seçmeden önce her iki politikayı da bilmek, sahne ortasında reddedilmelerden sizi kurtarır.

Tam kurulum: API anahtarından ilk yanıta

DeepSeek, GLM, Kimi, Claude, Gemini ve Grok'u tek bir anahtarla kapsayan bir anahtar istiyorsanız, APIsRouter gibi OpenAI uyumlu bir gateway düşük sürtünmeli bir yoldur: /topup'ta ödeme hesap kaydı gerektirmez, anahtar e-posta ile gelir ve JanitorAI için proxy URL'si https://api.apisrouter.com/v1/chat/completions'tır. SillyTavern de kullanıyorsanız bir nüans var: SillyTavern, /v1'de biten base URL'yi ister ve anahtarınızla model listesini /v1/models üzerinden otomatik doldurur, JanitorAI ise /chat/completions dahil tam yolu ister. Aynı endpoint, URL'nin farklı miktarda kısmı. İkisini karıştırmak, her iki uygulamada da 404 hatalarının en önde gelen nedenidir.

• Bir OpenAI uyumlu sağlayıcıdan veya gateway'den bir API anahtarı alın. Anahtar dizesine ve dokümante edilmiş endpoint URL'sine ihtiyacınız var.
• JanitorAI'de herhangi bir karakter sohbeti açın, ardından API Settings'i açın ve Proxy seçeneğini seçin.
• /chat/completions ile biten tam endpoint URL'sini proxy URL alanına yapıştırın.
• Model ID'sini dokümante edildiği gibi tam olarak yazın, örneğin deepseek-v4-flash veya glm-5.
• API anahtarını yapıştırın, ayarları kaydedin ve kayıt işlemi kaydolmazsa sayfayı yenileyin.
• Tek satırlık bir test mesajı gönderin. Normal bir yanıt, tüm zincirin çalıştığı anlamına gelir.

JanitorAI'yi suçlamadan önce endpoint'i curl ile test edin

Bir proxy kötü davrandığında, endpoint'i önce JanitorAI dışında test edin. 10 saniyelik bir curl çağrısı, sorunun endpoint'te mi, anahtarda mı, yoksa siteyi yapılandırma şeklinizde mi olduğunu söyler. Bunu kendi anahtarınız ve modelinizle herhangi bir terminalde çalıştırın:

curl https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Reply with one short sentence."}]
  }'

429 hatası: ücretsiz proxy'ler zirve saatlerde neden rate limitine takılıyor

429 yanıtı "çok fazla istek" anlamına gelir. JanitorAI topluluğunda açık ara en çok bildirilen proxy hatasıdır ve arkasındaki desen öngörülebilirdir. Ücretsiz veya paylaşılan bir proxy, yüzlerce veya binlerce kullanıcıya hizmet veren tek bir API anahtarıdır. Sağlayıcılar dakika başına istek ve dakika başına token için anahtar bazında sınırlar uygular, bu yüzden ABD akşam trafiği zirve yaptığında herkes aynı kotadan geçer ve anahtar istekleri reddetmeye başlar. Özellikle sizi hedef almıyorlar. Kova (bucket) basitçe boş ve en çok insanın sohbet etmek istediği tam da o anda en yavaş doluyor. Ücretsiz proxy'lerin ikinci bir başarısızlık modu var: anahtarın kendisi ölür. Paylaşılan anahtarlar politika ihlalleri veya tükenen bakiyeler nedeniyle iptal edilir, bu noktada aynı URL genellikle hiçbir duyuru yapılmadan 401 veya 404 döndürmeye başlar. Ücretli endpoint'ler zirve saat duvarını yapısal olarak önler. Anahtarınız bir kalabalıkla tek bir kovayı paylaşmak yerine kendi kotasına sahiptir, faturalandırma token başına olduğu için sağlayıcının sizi bir abonelik katmanına doğru kısmasının bir nedeni yoktur ve kapasite ödeme yapan trafik için ayrılmıştır. Kişisel ücretli bir anahtarda 429 görüyorsanız, bu neredeyse her zaman kısa bir patlama (burst) sınırıdır: birkaç saniye bekleyip yeniden deneyin veya hızlı ardışık yeniden üretimleri yavaşlatın. Kişisel bir anahtarda kalıcı 429'lar bir geçici çözüm değil, bir destek talebine değer.

JanitorAI proxy hata tablosu: 429, 401, 404, zaman aşımı

JanitorAI'nin gösterdiği kodu bu tabloyla eşleştirin. Çözüm sütunu, yukarıdaki curl testiyle endpoint'in çalıştığını zaten doğruladığınızı varsayar; curl aynı şekilde başarısız olursa, sorun JanitorAI'de değil endpoint tarafındadır.

Janitor AI proxy'nizin arkasında hangi modeli çalıştırmalı

Model seçimi, herhangi bir üretim ayarı ince ayarından daha önemlidir. Topluluk uzlaşısı istikrarlıdır: DeepSeek V4 ailesi, maliyetin bir düşünce olmaktan çıktığı fiyatlarda uzun, karakterde kalan yanıtlar yazdığı için roleplay favorisidir. GLM-5, Kimi K2.6 ve MiMo, farklı bir ses istediğinizde denemeye değer fiyat/performans seçenekleridir. Grok 4.5, xAI'nin yayınladığı politika açıkça kurgusal ortamlarda yetişkin kullanıcılar için olgun temalara izin verdiği için esnek politikalı seçenekler arasında listelenir. Claude Sonnet 4.6 katalogdaki en güçlü nesiri yazar ve SFW yaratıcı yazıma uyar; Anthropic'in politikası açık içeriği yasaklar, bu yüzden onu hikaye odaklı, açık olmayan sohbetlerde tutun. Aşağıdaki tüm katalog fiyatları abonelik olmadan kullandıkça ödemedir. Global modeller resmi oranların %20 altında fiyatlandırılır ve Çin modelleri resmi fiyatlandırmanın altındadır, ilk yükleme başlangıç bakiyenizi ikiye katlar.

Sık sorulan sorular