Dokumentasi

SillyTavern

Sumber Custom (OpenAI-compatible) SillyTavern memerlukan URL dasar dan kunci. Arahkan ke Kunavo agar Claude dan GPT muncul dalam daftar model yang sama.

Untuk menghubungkan SillyTavern ke Kunavo, buka API Connections, atur API ke Chat Completion dan Chat Completion Source ke Custom (OpenAI-compatible), lalu isi dua kolom: Custom Endpoint = https://api.kunavo.com/v1 dan Custom API Key = kunci sk-kn-… Anda. Tekan Connect; SillyTavern akan memanggil GET /v1/models dan mengisi daftar model dari responsnya.

Kolom SillyTavern	Nilai
API	Penyelesaian Chat
Sumber Penyelesaian Chat	Kustom (kompatibel dengan OpenAI)
Endpoint Kustom (URL Dasar)	`https://api.kunavo.com/v1`
Kunci API Kustom	`sk-kn-…`
Model yang Tersedia	Terisi otomatis setelah Connect — pilih ID apa pun

Akhiran /v1 harus disertakan dalam kolom ini. Sumber kustom SillyTavern mengikuti konvensi OpenAI dan hanya menambahkan jalurnya, jadi penggunaan https://api.kunavo.com tanpa /v1 akan menyebabkan koneksi gagal dan daftar model kosong.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Di SillyTavern, buka ikon steker (API Connections) di bilah atas.
Atur API → Chat Completion, lalu Chat Completion Source → Custom (OpenAI-compatible).
Tempel https://api.kunavo.com/v1 ke dalam Custom Endpoint dan masukkan kunci ke Custom API Key.
Tekan Connect. Status hijau dan daftar tarik-turun Available Models yang terisi berarti koneksi berhasil.
Pilih ID model dari daftar tarik-turun dan mulai obrolan. Beralih model nanti tidak memerlukan koneksi ulang.

Referensi SillyTavern untuk layar ini adalah halaman koneksi API Chat Completions.

Verifikasi sebelum men-debug antarmuka

Satu permintaan dapat memastikan apakah masalahnya ada pada endpoint, kunci, atau SillyTavern. Jika permintaan ini menghasilkan daftar ID model dalam JSON, URL dan kunci yang sama akan mengisi daftar model.

# Confirms the key and the endpoint before you touch SillyTavern.
# A JSON list of model ids means the same URL will populate the dropdown.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Model yang sebaiknya dipilih

Semua model teks di Kunavo dapat diakses dari daftar yang sama—daftar lengkap tersedia di halaman model dan ditampilkan secara langsung dari GET /v1/models. Tarif dinyatakan dalam USD per 1M token, input / output.

ID model	Kunavo masuk / keluar	Kesesuaiannya
`claude-haiku-4-5`	$0.70 / $3.50	Claude termurah — untuk sesi panjang saat biaya per giliran paling penting
`claude-sonnet-5`	$1.40 / $7.00	Keseimbangan kualitas dan harga sebagai pilihan default
`claude-opus-5`	$3.50 / $17.50	Tingkat Claude dengan kualitas tertinggi
`claude-fable-5`	$7.00 / $35.00	Penalaran mutakhir dengan jendela konteks 1M token — pilihan saat riwayat obrolan itu sendiri menjadi masalah

Panjang konteks adalah batas yang paling cepat terasa dalam sesi SillyTavern yang panjang: seluruh riwayat dikirim ulang pada setiap giliran, sehingga penggunaan token bertambah seiring percakapan dan tidak tetap. Kunavo menagih per token dari saldo prabayar tanpa biaya bulanan, jadi bulan tanpa penggunaan tidak dikenai biaya—detailnya ada di penagihan, dan penyimpanan prompt adalah cara paling efektif untuk mengurangi biaya pada konteks yang berulang.

Pemecahan masalah

Gejala	Penyebab	Perbaikan
Koneksi gagal, daftar model tetap kosong	`/v1` tidak ada di Custom Endpoint	Gunakan `https://api.kunavo.com/v1`. Konfirmasikan dengan curl di atas.
401 / kunci tidak valid	Kunci ditempel dengan spasi tambahan atau sudah dicabut	Salin ulang dari `/app/keys`; lihat 401 dan 403
Balasan tiba sekaligus, tidak dialirkan	Proksi di depan koneksi menampung server-sent events	Streaming didukung di sisi endpoint — kesalahan streaming
ID model ditolak	ID tidak disediakan oleh endpoint ini	Pilih dari daftar tarik-turun, atau lihat model_not_found
Kesalahan hanya terjadi pada obrolan panjang	Riwayat sudah melampaui jendela konteks model	Pangkas riwayat atau beralih ke model dengan konteks lebih panjang — context_length_exceeded

Dua catatan penting

Tidak berafiliasi

SillyTavern adalah proyek sumber terbuka independen dan tidak berafiliasi dengan Kunavo. Halaman ini menjelaskan konfigurasi yang berfungsi karena SillyTavern mendukung endpoint sembarang yang kompatibel dengan OpenAI—tidak ada konfigurasi khusus di kedua sisi.

Kebijakan konten tetap berlaku

Permintaan melalui Kunavo diteruskan ke penyedia upstream, dan setiap penyedia menerapkan kebijakan penggunaan masing-masing terhadap konten yang dikirimkan. Gateway tidak menghapus batasan tersebut, dan halaman mana pun yang menyatakan sebaliknya sedang mencoba menjual sesuatu. Ketentuan Kunavo sendiri tercantum dalam kebijakan penggunaan yang dapat diterima.

Pertanyaan umum

Bagaimana cara menghubungkan SillyTavern ke endpoint API kustom?

Di SillyTavern, buka tab API Connections (ikon steker), atur API ke Chat Completion dan Chat Completion Source ke Custom (OpenAI-compatible). Masukkan URL dasar yang kompatibel dengan OpenAI dari gateway ke Custom Endpoint—untuk Kunavo, nilainya adalah https://api.kunavo.com/v1—masukkan kunci ke Custom API Key, lalu tekan Connect. SillyTavern kemudian memanggil GET /v1/models pada endpoint tersebut dan mengisi daftar model dari responsnya.

Apakah SillyTavern dapat menggunakan model Claude melalui endpoint yang kompatibel dengan OpenAI?

Ya. Sumber Custom (OpenAI-compatible) di SillyTavern hanya memerlukan endpoint yang mengimplementasikan POST /v1/chat/completions, sehingga model Claude yang disediakan dalam format tersebut dapat digunakan tanpa memakai sumber Anthropic terpisah milik SillyTavern. Di Kunavo, ID model Claude dan GPT muncul dalam satu daftar di balik satu kunci, dan Anda dapat beralih di antaranya tanpa perlu menyambungkan ulang.

Apakah streaming berfungsi di SillyTavern dengan endpoint kustom?

Streaming berfungsi selama endpoint mengimplementasikan server-sent events pada /v1/chat/completions, seperti yang dilakukan Kunavo. Jika respons hanya muncul sebagai satu blok lengkap, penyebab umumnya adalah proksi di depan koneksi yang menampung aliran data, bukan endpoint itu sendiri.

Mengapa daftar model SillyTavern kosong setelah terhubung?

Daftar model SillyTavern yang kosong berarti panggilan GET /v1/models gagal. Masalahnya ada pada endpoint atau kunci, bukan pada SillyTavern. Dua penyebab yang umum adalah URL dasar tidak memiliki akhiran /v1 dan kunci yang tidak valid untuk endpoint tersebut. Menjalankan curl ke /v1/models dengan kunci yang sama akan mereproduksi kegagalan di luar SillyTavern dan membantu menentukan penyebabnya.