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.

Nilai permulaan untuk preset Chat Completion. Laraskan satu pada satu masa.
TetapanTitik permulaanApa yang ia lakukan dalam roleplay
Temperature0.8Lebih tinggi (sehingga 1.1) memberi prosa yang bervariasi; lebih rendah (0.6) jika watak terkeluar daripada kad
Top P0.95Biarkan sahaja melainkan balasan menjadi tidak koheren, kemudian turunkan sedikit
Frequency penalty0.1Melawan ritma ayat berulang dalam sembang panjang
Presence penalty0.05Nilai kecil mengelakkan gelung topik
Max response tokens350300 hingga 500 sesuai untuk balasan gaya perenggan tanpa merepek
Context sizeHad model atau 16kLebih 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 ModelKekuatan dalam SillyTavernNota polisi kandungan
deepseek-v4-flashKegemaran komuniti untuk sembang panjang; nilai terbaik setiap mesejPolisi fleksibel untuk fiksyen; mengikut kad watak dengan baik
deepseek-v4-proPematuhan arahan lebih kukuh untuk kad kompleks dan sembang kumpulanKeluarga sama seperti Flash dengan koheren lebih baik
glm-5Suara prosa yang berbeza; rentak baik dalam adegan perlahanPilihan nilai untuk sembang berat naratif
kimi-k2.6Ingatan konteks panjang untuk lorebook besarPilihan nilai; mengendalikan kad besar tanpa terlupa
grok-4.5Improvisasi dan gurauan yang kuatPolisi xAI membenarkan tema matang dalam latar fiksyen
claude-sonnet-4-6Kualiti prosa tertinggi untuk harganyaSFW sahaja untuk penulisan kreatif; Anthropic melarang kandungan eksplisit
claude-opus-4-7Penulisan sastera bentuk panjang terbaikPolisi SFW sahaja sama seperti Sonnet
gemini-3.5-flashBalasan pantas, konteks panjangPolisi 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.

Harga katalog dalam USD. kimi-k2.6 dan MiMo juga tersedia dalam katalog.
ModelInput / 1M tokenOutput / 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.