Setup proxy Janitor AI: format URL, model, dan solusi 429

Jawaban singkat: tiga field yang diminta JanitorAI

Konfigurasi proxy JanitorAI hanya butuh tiga nilai: proxy URL, nama model, dan API key. Proxy URL harus endpoint chat completions lengkap, bukan base URL. Kalau provider Anda memberi base URL yang berakhir di /v1, tambahkan /chat/completions sebelum menempelnya ke JanitorAI. Detail tunggal ini menyebabkan lebih banyak setup gagal daripada semua penyebab lain digabung. Masukkan model ID persis seperti yang dieja provider, huruf kecil dan tanda hubung termasuk, lalu simpan dan kirim pesan tes singkat. Kalau ada balasan yang kembali, Anda selesai. Kalau malah dapat kode error, lompat ke tabel error di bawah. Setiap kode umum punya penyebab spesifik dan solusi spesifik.

Proxy URL:  https://api.apisrouter.com/v1/chat/completions
Model:      deepseek-v4-flash
API Key:    sk-...   (tempel persis, tanpa tanda kutip, tanpa spasi di akhir)

Apa arti "proxy" di komunitas JanitorAI

Kata ini menyesatkan. Dalam slang JanitorAI, proxy bukan network proxy atau VPN. Ini adalah endpoint API OpenAI-compatible mana pun yang dikirimi request chat Anda oleh situs, menggantikan backend defaultnya. Komunitas mengadopsi istilah ini bertahun-tahun lalu ketika orang mulai merutekan chat lewat reverse proxy dari API provider, dan namanya melekat meski kebanyakan setup hari ini berbicara langsung ke provider atau gateway. Orang menjalankan proxy karena tiga alasan. Pertama, pilihan model: Anda memilih persis LLM mana yang menulis karakter Anda alih-alih menerima apa pun default dari situs. Kedua, kualitas: model seperti DeepSeek V4 atau Claude menulis scene yang lebih panjang dan koheren dibanding tier bawaan gratis. Ketiga, kontrol biaya: dengan key pay-per-token Anda melihat persis berapa biaya tiap chat alih-alih membayar langganan yang mungkin tidak sepenuhnya Anda pakai. Ada tiga jenis endpoint yang akan Anda lihat dibagikan di komunitas. API provider resmi (OpenAI, Anthropic, xAI, DeepSeek) membutuhkan akun dengan masing-masing vendor. Gateway mengagregasi banyak model di belakang satu URL OpenAI-compatible dan satu key. "Proxy gratis" komunitas adalah key bersama yang dibayar orang lain, itulah kenapa mereka tidak stabil dan sangat dibatasi rate-nya. Satu hal lagi yang perlu dikatakan dengan jelas: endpoint apa pun yang Anda pakai, content policy provider model upstream tetap berlaku untuk setiap respons, dan terms milik JanitorAI sendiri, termasuk persyaratan khusus dewasanya, tetap mengatur platform ini. Mengetahui kedua kebijakan itu sebelum memilih model menghindarkan Anda dari penolakan di tengah scene.

Setup lengkap: dari API key sampai balasan pertama

Kalau Anda ingin satu key yang mencakup DeepSeek, GLM, Kimi, Claude, Gemini, dan Grok sekaligus, gateway OpenAI-compatible seperti APIsRouter adalah rute yang paling mudah: checkout di /topup tidak butuh signup akun, key dikirim lewat email, dan proxy URL untuk JanitorAI adalah https://api.apisrouter.com/v1/chat/completions. Satu nuansa kalau Anda juga memakai SillyTavern: SillyTavern menginginkan base URL yang berakhir di /v1 dan otomatis mengisi daftar modelnya dari /v1/models dengan key Anda, sementara JanitorAI menginginkan path lengkap termasuk /chat/completions. Endpoint yang sama, jumlah URL yang berbeda. Mencampur kedua format ini adalah penyebab utama error 404 di kedua aplikasi.

• Dapatkan API key dari provider atau gateway OpenAI-compatible. Anda butuh string key dan endpoint URL yang terdokumentasi.
• Buka chat karakter mana pun di JanitorAI, lalu buka API Settings dan pilih opsi Proxy.
• Tempel endpoint URL lengkap yang berakhir di /chat/completions ke field proxy URL.
• Ketik model ID persis seperti yang terdokumentasi, misalnya deepseek-v4-flash atau glm-5.
• Tempel API key, simpan setting, dan refresh halaman kalau simpan tidak terekam.
• Kirim pesan tes satu baris. Balasan normal berarti seluruh rantai berfungsi.

Test endpoint dengan curl sebelum menyalahkan JanitorAI

Kalau proxy bertingkah aneh, test endpoint di luar JanitorAI dulu. Panggilan curl 10 detik memberi tahu Anda apakah masalahnya di endpoint, key, atau cara Anda mengonfigurasi situs. Jalankan ini di terminal mana pun, dengan key dan model Anda sendiri:

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."}]
  }'

Error 429: kenapa proxy gratis rate-limit di jam sibuk

Respons 429 berarti "terlalu banyak request". Ini sejauh ini error proxy yang paling banyak dilaporkan di komunitas JanitorAI, dan polanya bisa diprediksi. Proxy gratis atau bersama adalah satu API key yang melayani ratusan atau ribuan pengguna. Provider menegakkan batas per-key pada request per menit dan token per menit, jadi saat traffic malam hari AS memuncak, semua orang menyempit lewat quota yang sama dan key mulai menolak request. Anda tidak sedang ditarget khusus. Ember-nya sekadar kosong, dan mengisi ulang paling lambat justru saat paling banyak orang ingin chat. Proxy gratis punya mode kegagalan kedua: key itu sendiri mati. Key bersama di-revoke karena pelanggaran kebijakan atau saldo yang habis, dan pada titik itu URL yang sama mulai mengembalikan 401 atau 404, seringkali tanpa pengumuman. Endpoint berbayar menghindari tembok jam sibuk secara struktural. Key Anda mendapat quota sendiri alih-alih berbagi satu ember dengan keramaian, billing per token jadi provider tidak punya alasan untuk men-throttle Anda ke tier langganan, dan kapasitas disediakan untuk traffic berbayar. Kalau Anda melihat 429 di key berbayar pribadi, itu hampir selalu limit burst singkat: tunggu beberapa detik dan coba lagi, atau perlambat regenerate beruntun. 429 yang persisten di key pribadi layak diajukan sebagai support ticket, bukan workaround.

Tabel error proxy JanitorAI: 429, 401, 404, timeout

Cocokkan kode yang ditunjukkan JanitorAI dengan tabel ini. Kolom solusi mengasumsikan Anda sudah memastikan endpoint berfungsi dengan test curl di atas; kalau curl gagal dengan cara yang sama, masalahnya ada di sisi endpoint, bukan di JanitorAI.

Model mana yang harus dijalankan di belakang proxy Janitor AI Anda

Pilihan model lebih penting daripada tweak generation-settings apa pun. Konsensus komunitas stabil: keluarga DeepSeek V4 adalah favorit untuk roleplay karena menulis respons yang panjang dan sesuai karakter dengan harga yang membuat biaya berhenti jadi pertimbangan. GLM-5, Kimi K2.6, dan MiMo adalah pilihan value yang layak dirotasi kalau Anda ingin suara yang berbeda. Grok 4.5 masuk daftar opsi kebijakan fleksibel karena kebijakan yang dipublikasikan xAI mengizinkan tema dewasa dalam setting yang jelas-jelas fiksi untuk pengguna dewasa. Claude Sonnet 4.6 menulis prosa terkuat di katalog dan cocok untuk creative writing SFW; kebijakan Anthropic melarang konten eksplisit, jadi jaga tetap di chat yang berbasis cerita dan non-eksplisit. Semua harga katalog di bawah bayar sesuai pemakaian tanpa langganan. Model global dihargai 20% di bawah tarif resmi dan model China di bawah harga resminya, dan top-up pertama menggandakan saldo awal Anda.

Pertanyaan umum