Panduan Integrasi API SillyTavern: Hubungkan GPTProto dan Mulai Roleplay

Langkah 1: Instal dan Jalankan SillyTavern

SillyTavern menjalankan antarmuka obrolan, kartu karakter, dan pengaturan prompt di komputer Anda. Model yang terhubung akan menghasilkan balasan. Dokumentasi proyek resmi menggambarkannya sebagai frontend sumber terbuka (open-source) yang gratis.

Siapkan Node.js LTS, Git, akun GPT Proto dengan saldo API yang tersedia, dan ID model. Inferensi cloud melalui GPT Proto tidak mengharuskan Anda mengunduh bobot model atau menjalankan model di GPU Anda.

Instal di macOS

Unduh versi LTS dari halaman unduhan Node.js, pilih macOS, dan gunakan penginstalnya jika Anda lebih suka instalasi grafis.

Pilih rilis LTS saat ini untuk sistem operasi Anda.

Buka Terminal dan periksa Git:

git --version

Instal Git jika perlu, lalu jalankan:

cd ~
git clone https://github.com/SillyTavern/SillyTavern -b release
cd SillyTavern
bash start.sh

Peluncuran pertama akan menginstal dependensi. Biarkan terminal tetap terbuka saat menggunakan SillyTavern, dan buka alamat lokal yang tertera di sana jika browser tidak terbuka secara otomatis. Perintah-perintah ini mengikuti instruksi instalasi macOS resmi.

Peluncuran pertama akan mengunduh dependensi yang diperlukan.

Untuk meluncurkannya kembali nanti:

cd ~/SillyTavern
bash start.sh

Instal di Windows

Instal Node.js LTS dan Git for Windows. Buat folder seperti C:\AI, buka di File Explorer, ketik cmd di bilah alamat, lalu tekan Enter. Jalankan:

git clone https://github.com/SillyTavern/SillyTavern -b release

Buka folder SillyTavern yang telah diunduh dan klik dua kali Start.bat. Biarkan konsolnya tetap terbuka saat mengobrol. Panduan Windows resmi menyarankan untuk menghindari folder yang dikontrol Windows seperti Program Files dan menjalankan file startup tanpa izin administrator.

Langkah 2: Hubungkan SillyTavern ke GPT Proto

Masuk ke GPT Proto dan buka halaman model GLM-5.3. Bagian Penggunaan API-nya menyediakan pengenal model dan entri Buat Kunci API. Buat atau pilih kunci Anda, periksa tarif saat ini, dan siapkan saldo yang cukup untuk pengujian singkat.

Di SillyTavern, buka Koneksi API, menggunakan ikon steker di bilah atas. Masukkan:

Tempelkan kuncinya langsung ke bidang kunci. Jangan tambahkan Bearer, tanda kutip, atau header HTTP lengkap di sana.

Instruksi resmi Custom endpoint menentukan URL dasar tanpa /chat/completions; SillyTavern menambahkan akhiran tersebut. Untuk koneksi ini, bidang endpoint harus diakhiri dengan /v1.

Jika Anda sebelumnya mengikuti panduan pengaturan API Janitor AI kami, periksa perbedaan ini: URL Proxy Janitor menggunakan alamat https://gptproto.com/v1/chat/completions yang lengkap. Menyalin alamat lengkap tersebut ke bidang URL Dasar SillyTavern akan memberikan input yang salah.

Sesuaikan sumber, URL dasar, kunci, dan ID model dengan bidang di atas.

Klik Connect, lalu Test Message. Anda juga dapat mengirim Hello dari layar selamat datang. Panduan ini menghasilkan balasan yang ditunjukkan di bawah.

Pesan dasar mengonfirmasi bahwa koneksi dapat menghasilkan balasan.

Daftar Model Tersedia yang kosong tidak selalu berarti pembuatan tidak tersedia. Masukkan ID yang tepat secara manual saat penemuan model tidak tersedia. Untuk mengganti model nanti, gunakan ID model teks GPT Proto lain yang didukung dan uji kembali; fitur model dan parameter yang diterima bisa berbeda.

Langkah 3: Impor Kartu Karakter atau Buat Sendiri

Koneksi API yang berfungsi menyediakan model. Kartu karakter menyediakan identitas, suara, dan situasi awal.

Impor kartu karakter yang ada

Buka Characters → Import Character, pilih file kartu yang diunduh, dan pilih karakter yang diimpor untuk mulai mengobrol. Anda juga dapat menelusuri karakter melalui Extensions → Download Extensions & Assets.

Untuk kartu PNG, unduh file aslinya. Potret atau tangkapan layar biasa tidak berisi definisi karakter yang dapat digunakan kecuali data tersebut disematkan dalam gambar. FAQ resmi menjelaskan impor PNG yang tidak valid, termasuk kasus di mana menyimpan atau memproses gambar menghapus data yang disematkan di dalamnya.

Buat Noah Bennett dari teks

Pilih Create New Character. Mulailah dengan Nama, Deskripsi, dan Pesan Pertama; Anda dapat menambahkan bidang lanjutan nanti. Deskripsi memberi tahu model tentang karakter tersebut. Pesan Pertama menetapkan adegan pembuka dan menunjukkan gaya yang Anda inginkan. panduan desain karakter menjelaskan kedua bidang tersebut.

Gunakan editor karakter untuk identitas AI dan adegan pembuka.

Atur Name menjadi Noah Bennett. Tempel contoh asli ini ke dalam Description. {{char}} merujuk pada karakter dan {{user}} merujuk pada identitas pengguna yang Anda pilih.

Anda sedang bermain peran sebagai {{char}}, Noah Bennett, seorang pria berusia 25 tahun dengan fisik berotot, senyum yang ramah, dan kepribadian yang hangat serta penuh kasih sayang.

PENAMPILAN
Noah memiliki tinggi 188 cm, dengan bahu lebar, lengan kuat, dada bidang, dan kaki yang kuat hasil dari latihan kekuatan selama bertahun-tahun. Ia memiliki rambut cokelat tua yang sedikit berantakan, mata hazel yang hangat, janggut tipis, dan lesung pipi yang muncul saat ia menyeringai. Pakaiannya biasanya berupa kaus pas badan, celana jogger yang nyaman, dan sepatu kets. Suaranya rendah dan hangat, dan ia mudah tertawa.

KEPRIBADIAN
Noah adalah pria yang manis dengan kepercayaan diri yang santai. Ia perhatian, ekspresif secara fisik, dan nyaman menunjukkan kasih sayang. Ia senang membuat {{user}} tersenyum melalui godaan lembut, gestur penuh perhatian, dan pujian yang tulus. Daya tariknya berasal dari kombinasi tubuhnya yang gagah dan hatinya yang sangat lembut.

Ia memiliki pendapat, pertemanan, ambisi, dan hari-hari buruknya sendiri. Terkadang ia menyembunyikan kegugupan di balik lelucon dan menjadi sangat malu saat {{user}} memergokinya sedang bersikap sentimental. Ia bisa mengakui kesalahan dan menertawakan dirinya sendiri.

LATAR BELAKANG
Noah bekerja sebagai pelatih kebugaran dan berharap bisa membuka gym kecil di lingkungan sekitar. Di luar pekerjaan, ia menikmati memasak, mendaki, film komedi romantis yang buruk, dan bereksperimen dengan resep panekuk. Ia menanggapi latihan dengan serius tetapi tidak pernah menghakimi tubuh atau tingkat kebugaran orang lain.

HUBUNGAN DENGAN {{user}}
Noah dan {{user}} adalah tetangga ramah yang baru-baru ini mulai menghabiskan lebih banyak waktu bersama. Ia tertarik pada {{user}} dan menunjukkan ketertarikannya melalui perhatian, rayuan yang menyenangkan, dan ajakan untuk melakukan hal-hal biasa bersama. Biarkan kedekatan mereka berkembang melalui interaksi nyata.

GAYA MERAYU
Gayanya merayu hangat, spesifik, dan sedikit nakal. Ia mungkin menahan kontak mata sedikit lebih lama, mengingat minuman favorit, atau mengakui bahwa ia mencari alasan untuk mampir. Ia memperhatikan respons {{user}} dan menyesuaikan diri secara alami. Kasih sayang harus terasa disambut dan timbal balik.

GAYA BERMAIN PERAN
Tetaplah dalam karakter Noah selama cerita berlangsung. Gunakan dialog alami, gestur fisik kecil, dan detail konkret alih-alih penjelasan kepribadian yang panjang lebar.
Tulis tindakan dalam *tanda bintang* dan dialog dalam tanda kutip.
Biasanya merespons dalam satu hingga tiga paragraf pendek, menyisakan ruang bagi {{user}} untuk berpartisipasi.
Hanya kendalikan ucapan, tindakan, dan pikiran Noah. Serahkan dialog, keputusan, dan perasaan {{user}} kepada pengguna.
Pertahankan detail yang sudah ditetapkan dan tanggapi langsung apa yang baru saja terjadi.
Gunakan bahasa Inggris alami kecuali {{user}} meminta bahasa lain.

Tempel ini ke dalam First Message:

*Noah berdiri di luar pintu Anda dengan tas gym di bahu lebarnya dan kantong kertas kecil di tangannya. Rambut gelapnya masih sedikit lembap, dan kaus abu-abu pas badannya memiliki sedikit noda tepung di dekat keliman.*

"Sebelum kamu mengatakan apa pun—ya, aku bisa memasak makanan selain ayam dan nasi."

*Ia mengangkat kantong kertas itu, lesung pipinya muncul saat ia tersenyum.*

"Roti gulung kayu manis. Aku membuatnya terlalu banyak." *Jeda sejenak.* "Oke, aku sengaja membuat lebih karena aku berharap bisa bertemu denganmu."

"Jadi… apakah kamu ada waktu untuk minum kopi?"

Selesaikan pembuatan karakter, lalu pilih Noah. Simpan instruksi inti di Deskripsi dan pembukaan di Pesan Pertama. Catatan Kreator menyediakan metadata bagi orang yang membaca kartu dan tidak digunakan untuk menyusun prompt model.

Kartu Noah yang telah selesai memisahkan identitasnya yang berkelanjutan dari salam pembukanya.

Tetapkan Persona Anda sendiri

Karakter menentukan identitas AI. Persona menentukan identitas Anda. Buka Manajemen Persona, buat dan pilih persona, lalu tambahkan nama, avatar, dan deskripsi secara opsional, dengan mengikuti instruksi Persona resmi.

Untuk adegan fiksi ini, deskripsi singkat sudah cukup:

{{user}} adalah orang dewasa yang baru saja pindah ke lingkungan tersebut. Noah dan {{user}} adalah tetangga ramah yang sedang saling mengenal. {{user}} menentukan ucapan, tindakan, pilihan, dan perasaannya sendiri.

Gunakan detail fiksi yang ingin Anda ketahui oleh karakter; Anda tidak perlu memasukkan biografi asli Anda. Untuk ide penulisan karakter lainnya, lihat cara membuat karakter AI Anda sendiri dengan API.

Langkah 4: Mulai Percakapan Roleplay Pertama Anda

Buka obrolan Noah dan baca salamnya. Pada tangkapan layar, pengguna membalas ya, dan Noah menjawab, “Ya? Oke. Bagus.” Dia kemudian melanjutkan ajakan minum kopi dengan tindakan dan dialog. Kelanjutan yang dihasilkan itu adalah pemeriksaan koneksi yang berguna.

Untuk perintah yang lebih spesifik untuk dicoba sendiri, kirimkan:

"Jadi roti kayu manis itu hanya alasan untuk menemuiku?"
*Aku melirik kantong kertas, lalu kembali menatapnya.*

Periksa apakah balasannya mengikuti kepribadian Noah, merespons input terbaru Anda, dan menyerahkan keputusan kepada Anda. Jika gayanya perlu diperbaiki, edit satu bagian kartu dan coba obrolan baru. Hindari mengubah model, perintah karakter, dan beberapa pengaturan sekaligus; Anda akan memiliki lebih sedikit informasi tentang apa yang membantu.

Opsional: Tambahkan Info Dunia ke Karakter Anda

Info Dunia, yang juga disebut lorebook, menambahkan informasi latar ke perintah di bawah kondisi yang dikonfigurasi. Untuk eksperimen pertama, tambahkan satu lokasi dari adegan Noah.

Buka Info Dunia, buat lorebook, dan tambahkan entri yang diaktifkan menggunakan strategi pemicu kata kunci. Gunakan nilai contoh berikut:

Di panel karakter Noah, gunakan Lainnya… → Tautkan Info Dunia, atau tombol bola dunia lore karakter, untuk mengaitkan lorebook dengannya. Kemudian tanyakan, Seperti apa Corner Cafe itu?

Dokumentasi Info Dunia menjelaskan bahwa Konten entri adalah apa yang masuk ke dalam perintah; judul saja tidak memberikan fakta. Aktivasi juga bergantung pada pengaturan dan anggaran yang tersedia, dan model mungkin tidak menggunakan setiap detail yang diberikan. Mulailah dengan satu entri ringkas dan periksa perilakunya sebelum menambahkan dunia yang besar.

Berapa Biaya SillyTavern dengan GPT Proto?

GLM-5.3 adalah model yang digunakan untuk panduan ini. Pilih model Anda berdasarkan anggaran, kealamian dialog, ekspresi emosional, konsistensi karakter, dan kecepatan respons. Bandingkan kandidat dengan kartu dan adegan pembuka yang sama. Untuk obrolan harian, masukkan biaya konteks yang dipertahankan ke dalam anggaran Anda; untuk adegan berbasis cerita, periksa apakah suaranya terasa meyakinkan dan model membiarkan Anda menentukan pilihan sendiri.

SillyTavern sendiri gratis. Pembuatan model GPT Proto menggunakan saldo API Anda. Pada saat panduan ini dibuat, GLM-5.3 berada 15% di bawah tarif input dan output resminya di GPT Proto:

Tarif diperiksa pada 3 November 2026. Lihat panel harga GLM-5.3 untuk tarif terkini dan harga cache yang berlaku.

Permintaan ilustratif dengan 8.000 token input tanpa cache dan 500 token output yang dapat ditagih biayanya adalah:

(8.000 ÷ 1.000.000 × $1.19) + (500 ÷ 1.000.000 × $3.74)
= $0.01139

Ini adalah contoh perhitungan, bukan tagihan terukur untuk percakapan tangkapan layar. Output yang dapat ditagih bukanlah jumlah kata; gunakan penggunaan yang dilaporkan penyedia, termasuk token penalaran apa pun yang ditagih sebagai output.

Input dapat mencakup instruksi karakter, Persona, lore yang dipilih, dan riwayat percakapan yang dipertahankan. Seperti yang dijelaskan dalam ikhtisar koneksi API, SillyTavern menyusun ini ke dalam prompt. Konteks yang dipertahankan lebih lama dapat meningkatkan biaya balasan bahkan ketika pesan terbaru Anda hanya ya.

Mengapa Memilih GPT Proto untuk API SillyTavern Anda?

GPT Proto menawarkan model penyedia resmi dengan tarif diskon pada model tertentu, termasuk GLM-5.3. Satu kunci dan saldo bersama mencakup beberapa penyedia. Di SillyTavern, simpan kartu karakter dan koneksi Kustom Anda, ubah ke ID model obrolan lain yang didukung, dan bandingkan balasannya.

Untuk keandalan, model utama menggunakan saluran hulu redundan dan failover otomatis untuk membantu mengurangi gangguan saat saluran tidak tersedia. Anda dapat memilih antara model dengan harga dan gaya percakapan yang berbeda sambil tetap mempertahankan pengaturan Anda.

Sebelum sesi yang panjang, periksa ketersediaan model, biaya input/output, kecepatan respons, dan penanganan data. Mulailah dengan tes kecil dan tinjau penggunaannya. Halaman model SillyTavern memungkinkan Anda menjelajahi opsi dan membandingkan biaya.

Masalah Umum API SillyTavern dan Perbaikannya

Mulailah dengan obrolan baru dan pesan singkat. Kemudian cocokkan gejala dengan pemeriksaan berikutnya:

Model penalaran memerlukan perhatian khusus. Panduan penalaran resmi menjelaskan bahwa proses berpikir dapat menghabiskan token respons, bahkan saat disembunyikan. Tunjangan yang terlalu kecil untuk model tersebut dapat menyebabkan balasan yang terlihat kosong atau belum selesai. Periksa Panjang Respons Maksimum terhadap persyaratan model alih-alih menerapkan batas kecil yang sama pada setiap model.

Satu diskusi komunitas tentang lorebook dan balasan kosong menjelaskan seorang pengguna yang pulih setelah menghapus preset dan meningkatkan tunjangan respons. Keduanya diubah bersamaan, jadi laporan tersebut tidak mengisolasi satu penyebab. Hal ini mendukung urutan pemecahan masalah yang praktis: buat obrolan sederhana berfungsi, lalu tambahkan preset dan lore satu perubahan dalam satu waktu.

Opsional: Uji API di Luar SillyTavern

Dengan kunci Anda yang disimpan secara pribadi dalam variabel lingkungan GPTPROTO_API_KEY, perintah shell macOS/Linux ini mengirimkan permintaan langsung menggunakan format Chat Completions halaman model:

curl --request POST "https://gptproto.com/v1/chat/completions" \
  --header "Authorization: Bearer $GPTPROTO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "glm-5.3",
    "messages": [
      {"role": "user", "content": "Reply with: API connection works."}
    ]
  }'

Periksa respons yang berhasil yang berisi teks yang dihasilkan, bukan hanya indikator koneksi. Jika ini berhasil sementara SillyTavern gagal, bandingkan kolom klien dan parameter yang ditambahkan. Jika keduanya gagal, selidiki autentikasi, saldo, model, atau kesalahan layanan yang dikembalikan. Jauhkan kunci asli dari postingan pemecahan masalah publik.