ID ▾
Dapatkan kunci API

Pengaturan API SillyTavern: Cara terhubung secara kompatibel dengan OpenAI

Anda akan dijelaskan titik koneksi, kunci, nama model, dan nilai konteks yang sering membingungkan dalam pengaturan API SillyTavern, lengkap dengan perintah untuk verifikasi.

Tanggal pembaruan

Poin

  • Pilih metode koneksi Custom (Kompatibel OpenAI) pada Chat Completion
  • URL adalah https://api.mukenetsuapi.com/v1, nama model adalah uncensored
  • Konteks hingga 100.000 dimungkinkan, namun dibatasi demi biaya dan kecepatan
  • 401 mengindikasikan masalah kunci, 404 URL, 429 kemungkinan melebihi batas eksekusi paralel atau jumlah permintaan
Ilustrasi koneksi API SillyTavern yang menghubungkan topeng panggung dan steker server dengan kabel berkilau

Siapkan 3 hal yang diperlukan terlebih dahulu

Pengaturan API SillyTavern sebenarnya singkat; sebagian besar kesalahan terjadi pada nilai input. Siapkan 3 hal berikut terlebih dahulu.

  • Kunci API: Diterbitkan di halaman pengambilan kunci API. Setelah pendaftaran, Anda dapat menerima kredit uji coba senilai $0,50 dengan satu klik.
  • Base URL: https://api.mukenetsuapi.com/v1
  • Nama model: uncensored

SillyTavern adalah frontend yang memungkinkan Anda menambahkan endpoint kompatibel OpenAI. Karena API ini kompatibel dengan OpenAI, Anda tidak perlu memilih OpenAI resmi dan dapat mendaftarkannya sebagai endpoint kustom.

Langkah koneksi

Teks menu dapat berubah tergantung versi. Di sini kami menuliskan alur umum. Jika berbeda, Anda juga dapat memeriksa dokumentasi resmi SillyTavern.

  1. Buka "API Connections" (ikon steker) di bagian atas.
  2. Pilih jenis API sebagai "Chat Completion".
  3. Dari daftar sumber, pilih koneksi kustom (Custom) yang kompatibel dengan OpenAI.
  4. Masukkan https://api.mukenetsuapi.com/v1 ke URL endpoint. Jangan tambahkan /chat/completions di akhir.
  5. Tempelkan kunci yang telah diterbitkan di kolom kunci API. Pastikan tidak ada spasi di awal atau akhir.
  6. Atur nama model menjadi uncensored. Pilih dari daftar jika tersedia, atau ketik manual jika tidak.
  7. Tekan tombol koneksi dan verifikasi apakah muncul indikator sukses.

Memverifikasi kebenaran kunci dan URL melalui terminal sebelum koneksi akan memudahkan isolasi masalah.

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}'

Jika respons diterima, kunci, URL, dan nama model sudah benar. Jika SillyTavern masih gagal dalam kondisi ini, Anda dapat menduga kesalahan pada input aplikasi.

Tentukan panjang konteks dan respons

Jendela konteks API ini mendukung hingga 100.000 token untuk gabungan prompt dan output. Namun, Anda tidak disarankan mengatur ukuran konteks SillyTavern ke maksimum. Setiap kali, Anda harus mengirim ulang pengaturan karakter, latar dunia, dan riwayat; nilai yang lebih besar berarti input per permintaan yang lebih besar.

Contoh perhitungan biaya

Jika Anda menggunakan konteks hingga 16.000 token dan respons 300 token, biaya per pesan adalah sebagai berikut.

  • Input: 16.000 ÷ 1.000.000 × $0,15 = $0,0024
  • Output: 300 ÷ 1.000.000 × $0,50 = $0,00015
  • Total: $0,00255

Biayanya adalah $0,255 untuk 100 pesan. Jika Anda mempersempit jendela konteks menjadi 8.000, sisi input akan menjadi sekitar setengahnya. Lihat halaman harga untuk detail satuan.

Perkiraan

Jika bukan cerita panjang atau adegan banyak karakter, lebih realistis untuk memulai dengan 8.000 hingga 16.000 token, lalu menambahkannya jika karakter merasa melupakan peristiwa masa lalu. Panjang respons maksimum disesuaikan dengan panjang yang ingin Anda baca sebagai satu balasan. max_tokens opsional, tetapi disarankan menetapkan batas di sisi SillyTavern jika Anda ingin menghindari respons yang terlalu panjang.

Pendekatan pengaturan sampling

temperature, top_p, stop, seed, dan berbagai penalti diteruskan langsung ke API. Anda dapat menyesuaikannya dengan preset di SillyTavern.

  • Ungkapan yang berulang: tingkatkan penalti frekuensi atau kehadiran sedikit.
  • Respons menjadi tidak fokus: turunkan temperature.
  • Monoton: tingkatkan temperature sedikit.
  • Ingin membandingkan: kunci seed dan ubah nilai satu per satu.

Nama item preset berbeda tergantung versi SillyTavern. Jika pengaturan tidak diterapkan, periksa apakah metode koneksi yang Anda gunakan mendukung item tersebut di dokumentasi SillyTavern.

Kesalahan umum dan penanganannya

GejalaKemungkinan penyebabPenanganan
401Kunci tidak cocok atau ada spasiTempel ulang kunci dan coba dengan curl menggunakan kunci yang sama.
404URL salahPeriksa apakah URL berakhir dengan /v1.
Model tidak ditemukanEjaan nama modelMasukkan uncensored dengan huruf kecil.
429 (concurrency)Terlalu banyak permintaan simultanKurangi klik berulang saat menggeser atau pembuatan simultan di grup chat.
429 (rate_limited)Melebihi batas jumlah per menitTunggu sebentar.
429 (Retry-After: 5 dengan)Kemacetan sementaraTunggu 5 detik lalu coba lagi.

Batas kunci penuh adalah 8 secara bersamaan, 300 per menit; kunci uji coba adalah 2 secara bersamaan, 60 per menit. Respons streaming menggunakan 1 slot koneksi bersamaan hingga selesai. Menjalankan obrolan grup dengan kunci uji coba akan segera memenuhi slot.

Anda dapat memeriksa apakah saldo mencukupi dengan perintah berikut.

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

Anda juga dapat membacanya dari header respons X-Balance-USD. Untuk melihat daftar model, gunakan GET /v1/models.

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

Perhatian penggunaan

API ini khusus teks. Jika Anda ingin menggunakan fitur gambar atau suara di SillyTavern, layanan lain diperlukan. Konten ini mengasumsikan fiksi seperti novel, roleplay, atau aplikasi teman untuk penggunaan dewasa yang legal. Konten seksual yang melibatkan anak di bawah umur tidak dapat dihasilkan oleh pengaturan apa pun. Prompt tidak digunakan untuk pembelajaran model.

Parameter lebih lanjut ada di dokumentasi. Pembayaran menggunakan USDT (TRC20) atau USDC (Base) dengan jumlah bilangan bulat antara $20 hingga $500.

Panduan lainnya

Pertanyaan umum

Model apa yang digunakan di SillyTavern?

uncensored. Masukkan dengan huruf kecil persis seperti itu.

Apakah /chat/completions diperlukan di akhir URL?

Tidak perlu. Base URL cukup hingga /v1, sisa path ditambahkan oleh aplikasi.

Apakah kunci uji coba sudah cukup?

Sudah cukup untuk verifikasi koneksi dan percakapan singkat. Namun, kunci uji coba dibatasi menjadi 2 permintaan paralel dan 60 per menit dengan masa berlaku 7 hari. Jika Anda menggunakan grup chat, isi saldo kunci reguler.

Apakah gambar juga dapat dihasilkan?

Tidak bisa. API ini khusus teks dan tidak mendukung pembuatan gambar, suara, atau video.

Berapa ukuran konteks yang baik?

Maksimumnya adalah 100.000 token, tetapi realistis untuk memulai dengan 8.000 hingga 16.000. Semakin besar, semakin besar input per permintaan dan semakin tinggi biayanya.

Kunci API dapat diperoleh melalui 1 formulir

Buat akun, salin kunci, dan ubah base URL. Itu saja untuk menyelesaikan pengaturan.

Dapatkan kunci API