Persediaan API SillyTavern: URL asas, kunci API, dan senarai model
Updated 2026-07-15
Dalam SillyTavern, pilih Chat Completion, tetapkan sumber ke Custom (OpenAI-compatible), tampal URL asas yang berakhir di /v1, dan tambah kunci API anda. Senarai lungsur model kemudian terisi sendiri daripada endpoint /v1/models penyedia.
Jawapan pantas: lima tetapan yang penting
Buka panel API Connections (ikon plag) dan tetapkan tepat seperti ini: API = Chat Completion. Chat Completion Source = Custom (OpenAI-compatible). Custom Endpoint (Base URL) = https://api.apisrouter.com/v1. Custom API Key = kunci sk-... anda. Klik Connect, tunggu lampu hijau, dan pilih model daripada senarai lungsur, contohnya deepseek-v4-flash. Kegagalan paling biasa ialah menampal laluan penuh. SillyTavern menambah /chat/completions pada apa sahaja yang anda masukkan, jadi URL mesti berhenti di /v1. Jika anda menampal https://api.apisrouter.com/v1/chat/completions, SillyTavern meminta /v1/chat/completions/chat/completions dan sambungan gagal dengan ralat 404. Ini bertentangan dengan JanitorAI, yang mahukan URL completions penuh dalam konfigurasi proksinya. Penyedia sama, konvensyen medan berbeza.
Sebab URL API SillyTavern berakhir di /v1
Setiap API serasi OpenAI ialah URL asas ditambah satu set laluan tetap. GET /v1/models memulangkan senarai ID model yang boleh digunakan oleh kunci anda. POST /v1/chat/completions menjalankan permintaan sembang sebenar. SillyTavern mengetahui laluan ini dan membinanya sendiri, jadi ia hanya meminta URL asas daripada anda. Apabila anda klik Connect, ia memanggil /v1/models dengan kunci anda dan menggunakan respons itu untuk mengisi senarai lungsur model. Senarai lungsur kosong hampir selalu bermaksud panggilan itu gagal. Anda juga perlu memilih mod API yang betul. Chat Completion menghantar mesej berstruktur dengan peranan system, user, dan assistant, iaitu apa yang diharapkan oleh setiap penyedia serasi OpenAI yang dihoskan. Text Completion menghantar satu rentetan prompt mentah dan wujud terutamanya untuk backend tempatan seperti KoboldCpp dan text-generation-webui. Untuk mana-mana kunci API yang dihoskan, guna Chat Completion. Jika anda memilih Text Completion terhadap endpoint sembang yang dihoskan, anda akan mendapat ralat atau format yang rosak, dan beberapa sampler yang ditunjukkan dalam mod itu tidak terpakai pun.
Persediaan langkah demi langkah
Jika senarai lungsur kekal kosong selepas Connect, semak semula tiga perkara ini secara berurutan: URL berakhir di /v1 tanpa laluan tambahan dan tanpa ruang berlebihan, kunci ditampal tanpa tanda petik atau ruang kosong, dan sumbernya ialah Custom (OpenAI-compatible) bukan OpenAI biasa. Sumber OpenAI biasa mengabaikan URL tersuai anda pada sesetengah versi dan berkomunikasi dengan api.openai.com, di mana kunci anda tidak sah.
- Dapatkan kunci. Di APIsRouter tiada borang akaun: bayar di /topup dan kunci dihantar melalui e-mel. Mana-mana kunci serasi OpenAI berfungsi dengan cara yang sama dalam langkah ini.
- Dalam SillyTavern, klik ikon plag untuk membuka API Connections.
- Tetapkan API kepada Chat Completion.
- Tetapkan Chat Completion Source kepada Custom (OpenAI-compatible).
- Dalam Custom Endpoint (Base URL), masukkan https://api.apisrouter.com/v1 tanpa apa-apa selepas /v1.
- Tampal kunci anda ke dalam medan Custom API Key.
- Klik Connect. Titik status bertukar hijau dan senarai lungsur Available Models terisi daripada /v1/models.
- Pilih model, buka kad watak, dan hantar mesej ujian pendek.
Sahkan sambungan di luar SillyTavern
Apabila sesuatu gagal, uji endpoint secara langsung sebelum menyalahkan SillyTavern. Panggilan curl ini adalah tepat apa yang dilakukan oleh butang Connect. Jika ia memulangkan tatasusunan JSON bagi ID model, kunci dan URL anda adalah betul dan masalahnya ada pada medan SillyTavern. Jika senarai model berfungsi tetapi sembang gagal, jalankan satu completion sebenar dari Python dengan URL asas yang sama. Balasan yang berjaya di sini membuktikan keseluruhan rantaian, dan sebarang mesej ralat yang anda terima adalah ralat sebenar penyedia dan bukan ralat generik SillyTavern.
curl https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer sk-your-key"Asas sampler dan preset
Sumber Chat Completion mendedahkan set sampler yang kecil: temperature, top P, frequency penalty, dan presence penalty, ditambah panjang respons dan saiz konteks. Sampler lebih canggih yang mungkin pernah anda baca (min P, mirostat, dynamic temperature) adalah milik backend Text Completion dan hanya tidak dihantar kepada API sembang yang dihoskan, jadi jangan mencarinya di sini. Preset dalam SillyTavern menggabungkan dua perkara: nilai sampler dan struktur prompt yang dihimpun oleh Prompt Manager daripada kad watak, persona, dan lorebook anda. Preset Default terbina dalam adalah titik permulaan yang munasabah. Tukar satu nilai pada satu masa dan jana semula adegan yang sama untuk melihat apa yang sebenarnya ia lakukan. Saiz konteks patut diberi perhatian: SillyTavern mengisi tetingkap konteks dengan sejarah sembang, jadi konteks yang lebih besar bermaksud lebih banyak token prompt dihantar pada setiap giliran, yang meningkatkan ingatan dan menaikkan kos setiap mesej pada masa yang sama.
| Tetapan | Titik permulaan | Apa yang ia lakukan dalam roleplay |
|---|---|---|
| Temperature | 0.8 | Lebih tinggi (sehingga 1.1) memberi prosa yang bervariasi; lebih rendah (0.6) jika watak terkeluar daripada kad |
| Top P | 0.95 | Biarkan sahaja melainkan balasan menjadi tidak koheren, kemudian turunkan sedikit |
| Frequency penalty | 0.1 | Melawan ritma ayat berulang dalam sembang panjang |
| Presence penalty | 0.05 | Nilai kecil mengelakkan gelung topik |
| Max response tokens | 350 | 300 hingga 500 sesuai untuk balasan gaya perenggan tanpa merepek |
| Context size | Had model atau 16k | Lebih banyak sejarah setiap giliran; juga lebih banyak token input dibilkan setiap mesej |
Model yang disyorkan untuk SillyTavern
Pemilihan model lebih penting daripada penalaan sampler. Konsensus komuniti, setakat laporan anggaran yang ada, meletakkan keluarga DeepSeek V4 di tempat pertama untuk harga: deepseek-v4-flash ialah cadangan lalai untuk sembang panjang dan deepseek-v4-pro mengekalkan kad kompleks dan sembang kumpulan lebih baik bersama-sama. GLM-5, Kimi K2.6, dan MiMo adalah pilihan nilai yang kukuh dengan suara prosa yang berbeza, berbaloi untuk digilir apabila sembang mula terasa serupa. Grok penting kerana polisi rasmi xAI yang diterbitkan secara jelas membenarkan tema matang dalam latar fiksyen, yang penting untuk jalan cerita yang lebih gelap. Claude menulis prosa terbaik daripada semua dalam senarai ini tetapi polisi Anthropic melarang kandungan eksplisit, jadi anggap Claude sebagai pilihan untuk penulisan kreatif SFW dan adegan gaya sastera. Dua nota praktikal. Pertama, SillyTavern ialah perisian yang disasarkan untuk dewasa, dan setiap model di sini menguatkuasakan polisi kandungan penyedianya sendiri tanpa mengira frontend anda, jadi kekalkan kad dan adegan dalam peraturan tersebut. Kedua, kerana senarai lungsur diisi secara langsung daripada /v1/models, anda boleh menukar model di tengah sembang dan membandingkan balasan kepada mesej yang sama, iaitu cara terpantas untuk mencari kegemaran anda sendiri.
| ID Model | Kekuatan dalam SillyTavern | Nota polisi kandungan |
|---|---|---|
| deepseek-v4-flash | Kegemaran komuniti untuk sembang panjang; nilai terbaik setiap mesej | Polisi fleksibel untuk fiksyen; mengikut kad watak dengan baik |
| deepseek-v4-pro | Pematuhan arahan lebih kukuh untuk kad kompleks dan sembang kumpulan | Keluarga sama seperti Flash dengan koheren lebih baik |
| glm-5 | Suara prosa yang berbeza; rentak baik dalam adegan perlahan | Pilihan nilai untuk sembang berat naratif |
| kimi-k2.6 | Ingatan konteks panjang untuk lorebook besar | Pilihan nilai; mengendalikan kad besar tanpa terlupa |
| grok-4.5 | Improvisasi dan gurauan yang kuat | Polisi xAI membenarkan tema matang dalam latar fiksyen |
| claude-sonnet-4-6 | Kualiti prosa tertinggi untuk harganya | SFW sahaja untuk penulisan kreatif; Anthropic melarang kandungan eksplisit |
| claude-opus-4-7 | Penulisan sastera bentuk panjang terbaik | Polisi SFW sahaja sama seperti Sonnet |
| gemini-3.5-flash | Balasan pantas, konteks panjang | Polisi standard Google; baik untuk RP gaya pengembaraan |
Berapa kos sebenar sembang SillyTavern
Model yang dihoskan mengenakan bil per token, dan roleplay berat input: setiap giliran menghantar semula kad watak ditambah sejarah terkini. Satu giliran yang menghantar 8,000 token prompt dan menerima balasan 350 token berharga kira-kira sepersepuluh sen pada deepseek-v4-flash, jadi beberapa dolar meliputi berbulan-bulan sembang santai. Giliran yang sama pada claude-opus-4-7 berharga kira-kira 25 kali ganda lebih mahal, itulah sebabnya kebanyakan orang menjalankan pemandu harian yang murah dan menyimpan model premium untuk adegan yang mereka pentingkan. Satu kunci gateway meliputi keseluruhan jadual ini. APIsRouter ialah gateway serasi OpenAI dengan pengebilan bayar-mengikut-penggunaan dan tanpa langganan: anda bayar di /topup tanpa membuat akaun, kunci dihantar melalui e-mel, top up pertama anda menambah +100% sepadan pada baki anda, model global diharga 20% di bawah kadar rasmi, dan model Cina berada di bawah harga rasmi mereka.
| Model | Input / 1M token | Output / 1M token |
|---|---|---|
| deepseek-v4-flash | $0.126 | $0.252 |
| deepseek-v4-pro | $0.3915 | $0.783 |
| glm-5 | $0.514 | $2.314 |
| gemini-3.5-flash | $1.20 | $7.20 |
| claude-sonnet-4-6 | $2.40 | $12.00 |
| claude-opus-4-7 | $4.00 | $20.00 |
| gpt-5.5 | $4.00 | $24.00 |
| grok-4.5 | $1.60 | $4.80 |
Soalan lazim
URL API apa yang perlu saya masukkan dalam SillyTavern?
Hanya URL asas, berakhir di /v1. Untuk APIsRouter itu ialah https://api.apisrouter.com/v1. SillyTavern menambah /chat/completions sendiri, jadi memasukkan laluan completions penuh merosakkan sambungan dengan ralat 404.
Adakah terdapat API percuma untuk SillyTavern?
SillyTavern sendiri ialah perisian sumber terbuka percuma. Akses model yang dihoskan mengenakan bil per token, walaupun sesetengah penyedia menawarkan tier percuma dengan had kadar dan giliran yang ketat. Menjalankan model tempatan melalui KoboldCpp adalah percuma jika perkakasan anda mampu mengendalikannya. Dalam praktiknya, model dihoskan berbajet seperti deepseek-v4-flash berharga sebahagian kecil sen setiap mesej, cukup hampir dengan percuma untuk penggunaan santai tanpa kesakitan had kadar.
Kenapa senarai model SillyTavern saya kosong?
Panggilan Connect ke /v1/models gagal. Semak sama ada URL berakhir di /v1 tanpa laluan tambahan atau ruang, kunci ditampal bersih, dan sumbernya ialah Custom (OpenAI-compatible) bukan OpenAI biasa. Uji dengan curl terhadap /v1/models untuk melihat ralat sebenar penyedia.
Patutkah saya guna Chat Completion atau Text Completion dalam SillyTavern?
Chat Completion untuk mana-mana API serasi OpenAI yang dihoskan. Text Completion adalah untuk backend tempatan seperti KoboldCpp dan text-generation-webui yang menerima rentetan prompt mentah. Memilih Text Completion terhadap endpoint sembang yang dihoskan menyebabkan ralat atau format yang rosak.
Model mana yang terbaik untuk roleplay dalam SillyTavern?
Mulakan dengan deepseek-v4-flash, lalai komuniti biasa untuk sembang panjang pada kos rendah. Beralih ke deepseek-v4-pro untuk kad kompleks, cuba GLM-5 atau Kimi K2.6 untuk suara prosa yang berbeza, dan guna Claude untuk penulisan kreatif SFW berkualiti tertinggi. Grok sesuai untuk tema fiksyen matang di bawah polisi rasmi xAI.
Adakah kunci API saya selamat dalam SillyTavern?
Kunci disimpan secara tempatan dalam secrets.json SillyTavern pada mesin anda dan hanya dihantar kepada host API yang anda konfigurasikan. Jangan kongsi tangkapan skrin panel sambungan atau fail tetapan yang dieksport, dan tukar kunci jika anda mengesyaki ia bocor.