Persediaan API custom Narratium: URL asas, kunci, model.

Updated 2026-07-29

Narratium ialah klien roleplay dan penceritaan sumber terbuka yang membawa antara muka sendiri dan tiada model sendiri: README-nya mengarahkan pengguna ke API format OpenAI, endpoint bersatu gaya OpenRouter, dan Ollama tempatan. Arahkan tetapan API-nya ke https://api.apisrouter.com/v1 dengan satu kunci dan seluruh katalog menjadi backend-nya. Satu perkara yang dinyatakan halaman ini secara jelas, yang dilangkau kebanyakan panduan lain: repositori GitHub-nya telah diarkibkan, jadi jalankan ia dengan fakta itu diambil kira.

Jawapan pantas: nilai yang diperlukan Narratium.

Sambungan LLM Narratium ialah tiga serangkai standard serasi OpenAI, dimasukkan dalam tetapan API-nya: URL asas, kunci API, dan nama model. Untuk gateway ini nilainya ialah https://api.apisrouter.com/v1, kunci sk-... anda, dan mana-mana id katalog, dengan deepseek-v4-flash menjadi pilihan pertama yang munasabah untuk trafik cerita. README projek mengesyorkan tepat kelas sambungan ini: API format OpenAI secara langsung, endpoint bersatu berbilang model untuk kepelbagaian, atau Ollama dan LM Studio untuk model tempatan, semuanya melalui permukaan konfigurasi yang sama. Label medan yang tepat berbeza antara binaan web dan versi, jadi anggap label secara longgar dan nilai secara tepat: URL berakhir di /v1, kunci ditampal bersih, id model sepadan dengan rentetan katalog aksara demi aksara.

Base URL:  https://api.apisrouter.com/v1
API key:   sk-...              (dari APIsRouter)
Model:     deepseek-v4-flash   (ditaip tepat; mana-mana id katalog berfungsi)

Apa itu Narratium, dan statusnya, dinyatakan secara jelas.

Narratium (Narratium/Narratium.ai di GitHub) memperkenalkan dirinya sebagai VSCode untuk roleplay: klien sumber terbuka untuk penceritaan berpandukan AI, worldbuilding, dan fiksyen interaktif bentuk panjang, dengan keserasian kad watak SillyTavern, kekalan memori, dan sistem plugin. Kodnya berlesen AGPL, ia menarik komuniti sebenar dengan pantas, dan ia kekal sebagai salah satu klien terbuka yang paling menarik dalam senario ini. Sekarang bahagian yang dilangkau kebanyakan panduan persediaan: repositori GitHub-nya telah diarkibkan dan baca-sahaja (GitHub menunjukkan tarikh arkib sebagai 30 Mac 2026). Diarkibkan tidak bermaksud rosak, kod berjalan sama baik seperti hari ia dibekukan, tetapi ia bermaksud tiada penyelenggara yang menghantar pembetulan, kemas kini kebergantungan, atau tampalan keselamatan, dan instans yang dihoskan berkaitan projek ini harus dianggap sebagai usaha terbaik sahaja. Jika anda menggunakan Narratium hari ini, laluan yang boleh diharap ialah menjalankannya sendiri daripada sumber atau keluaran, dan jangkaan yang realistik ialah set ciri yang beku. Status itu mengubah nasihat API dalam satu cara khusus: klien yang beku adalah situasi tepat di mana anda mahu bahagian model kekal fleksibel. Narratium tidak boleh lagi menambah integrasi penyedia baharu, tetapi endpoint serasi OpenAI yang telah dituturkannya terus melayani apa sahaja model baharu yang muncul di sebalik endpoint itu. Corak gateway ini secara berkesan menahan-masa-depan klien yang tidak lagi bergerak.

Panduan persediaan.

Penyelesaian masalah mengikut corak sejagat: buktikan tiga nilai itu dengan permintaan curl dahulu, dan jika curl berjaya sementara aplikasi gagal, punca biasa ialah URL dengan segmen laluan yang tersasar, ruang putih dalam kunci, atau sekatan CORS pelayar pada binaan web, yang boleh dilihat dalam konsol pembangun. Oleh kerana tiada penyelenggara akan menghantar pembetulan untuk keanehan sisi aplikasi lagi, tabiat curl-dahulu penting sedikit lebih di sini: ia memberitahu anda dengan segera bahagian sambungan mana yang benar-benar boleh anda lakukan sesuatu.

  • Jalankan Narratium: hos sendiri daripada sumber GitHub atau keluaran (repo baca-sahaja tetapi masih boleh diklon sepenuhnya), atau guna instans yang dihoskan jika ada yang anda percayai masih beroperasi.
  • Buka tetapan dan cari bahagian konfigurasi API / LLM.
  • Pilih jenis sambungan format OpenAI dan bukan Ollama, kerana anda mengarah ke endpoint yang dihoskan.
  • Masukkan URL asas https://api.apisrouter.com/v1 dan tampal kunci anda.
  • Taip id model dengan tepat: deepseek-v4-flash untuk permulaan.
  • Simpan dan hantar satu mesej pendek dalam cerita baharu untuk mengesahkan perjalanan pergi-balik.

Kad, dunia, dan apa yang kekal jika anda beralih.

Narratium membaca kad watak serasi SillyTavern, yang merupakan fakta keserasian tunggal paling penting mengenainya. Watak anda ialah artifak mudah alih: kad yang ditulis di tempat lain boleh diimport, dan kerja yang anda letakkan ke dalam persona dan nota dunia tidak terikat kepada klien yang pembangunannya telah berhenti. Jika anda pernah berpindah, SillyTavern, RisuAI, dan Wyvern semuanya menuturkan susur galur kad yang sama, dan halaman persediaan yang dipautkan di bawah merangkumi setiap satu. Logik kemudahalihan yang sama terpakai pada bahagian model. Kerana Narratium bertutur dengan endpoint /v1 generik, tiada apa mengenai persediaan penyedia anda yang khusus untuk Narratium: kunci dan URL asas yang sama boleh dimasukkan ke mana-mana frontend lain tanpa berubah. Antara kad mudah alih dan endpoint mudah alih, kos pertukaran seluruh tindanan menghampiri sifar, yang merupakan sikap yang betul terhadap mana-mana projek diarkibkan yang masih anda gemari.

Pilihan model untuk gaya bentuk panjang Narratium.

Reka bentuk Narratium memberi tumpuan kepada naratif bercabang yang panjang, yang memberatkan pilihan model ke arah ketekalan berbanding jangka masa panjang. deepseek-v4-flash membawa sesi harian pada kadar terendah katalog dengan dialog yang komuniti roleplay sentiasa nilaikan melebihi harganya. glm-5.1 dan kimi-k2.6 bergilir untuk kepelbagaian suara, dan glm-5.2 layak mendapat bab padat perincian di mana ketaatan arahannya bagi jangka masa panjang mengatasi kependaman penaakulannya. claude-sonnet-4-6 kekal sebagai siling prosa selamat-untuk-kerja bagi bab yang layak mendapatnya. Kerana frontend menghantar semula konteks cerita setiap giliran, token input mendominasi kos, dan tetingkap kerja yang disengajakan mengatasi yang maksimum; panduan panjang konteks yang dipautkan di bawah mengira ini. Polisi kandungan tidak berubah oleh mana-mana ini: polisi model dan terma platform yang terpakai berlaku seperti ditulis, dan halaman perbandingan polisi merangkumi keluarga mana yang sesuai dengan penarafan kandungan mana, secara fakta.

Bayar mengikut penggunaan · bawah harga rasmi

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

ModelHarga RasmiHarga Kami
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M
GLM-5.1$0.86 / $3.43 per M$0.90 / $3.40 per M
Kimi K2.6$0.95 / $4.00 per M$1.00 / $4.00 per M
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M

Patutkah anda masih menggunakan klien yang diarkibkan?

Kos-manfaat yang jujur, kerana halaman ini adalah panduan persediaan dalam kedua-dua keadaan. Menyokong: kodnya terbuka, antara muka benar-benar bagus untuk cerita bentuk panjang berstruktur, kad mudah alih masuk dan keluar, dan endpoint generik mengekalkan bahagian model terkini selamanya. Menentang: tiada tampalan keselamatan, tiada pembetulan pepijat, kebergantungan yang semakin tua di tempatnya, dan mana-mana instans yang dihoskan hidup atas masa pinjaman. Bagi klien hobi yang berjalan secara tempatan terhadap kunci berukur, profil risiko itu boleh diterima oleh ramai orang; bagi apa-apa dengan pengguna lain atau data sensitif, ia tidak boleh. Laluan pertengahan ialah yang telah diterangkan halaman ini sepanjang masa: jalankan sendiri, kekalkan pelaburan anda dalam lapisan mudah alih (kad, lorebook, endpoint), dan anggap klien sebagai boleh diganti. Frontend dalam senario ini datang dan pergi; cerita yang disokong oleh kad mudah alih dan endpoint /v1 yang stabil mengatasi mereka semua.

Soalan lazim

Bagaimana saya menetapkan URL asas API custom dalam Narratium?

Dalam tetapan API, pilih sambungan format OpenAI, kemudian masukkan URL asas https://api.apisrouter.com/v1, kunci anda, dan id model yang tepat seperti deepseek-v4-flash. README mengesyorkan API format OpenAI atau endpoint bersatu berbilang model, yang merupakan tepat konfigurasi ini.

Adakah Narratium masih diselenggara?

Tidak. Repositori GitHub telah diarkibkan dan baca-sahaja (GitHub menunjukkan 30 Mac 2026 sebagai tarikh arkib), jadi tiada pembetulan atau kemas kini dihantar. Kod masih berjalan dan kekal boleh diklon; hos sendiri ialah cara yang boleh diharap untuk menggunakannya, dengan jangkaan ditetapkan kepada set ciri yang beku.

Adakah Narratium berfungsi dengan kad watak SillyTavern?

Ya, keserasian kad dengan format SillyTavern adalah salah satu ciri yang didokumentasikan, yang mengekalkan watak anda mudah alih dalam kedua-dua arah: kad diimport ke dalam Narratium, dan kerja anda tidak terkandas jika anda kemudian berpindah ke SillyTavern, RisuAI, atau Wyvern.

Model mana yang berfungsi dengan Narratium melalui gateway?

Apa sahaja yang dilayani endpoint, kerana Narratium menghantar nama model sebagai rentetan biasa: deepseek-v4-flash dan glm-5.1 untuk volum, kimi-k2.6 untuk rotasi, glm-5.2 untuk bab padat perincian, claude-sonnet-4-6 untuk prosa selamat-untuk-kerja. Bertukar hanyalah perubahan tetapan, dan sejarah sembang kekal bersama klien.

Bolehkah saya menjalankan Narratium sepenuhnya secara tempatan?

Ya, dalam dua erti: klien hos sendiri daripada sumber yang diarkibkan, dan sokongan Ollama-nya juga menjalankan model secara tempatan. Hibrid yang kebanyakan orang gunakan ialah klien tempatan dengan endpoint yang dihoskan di sebaliknya, yang mengekalkan pengendalian data di tangan anda sambil mencapai model yang tiada GPU pengguna layani.

Adakah menggunakan endpoint custom melanggar mana-mana terma?

Narratium adalah sumber terbuka dan dibina untuk tepat konfigurasi ini. Apa yang tidak pernah diubah oleh endpoint custom ialah polisi kandungan sisi model: peraturan bertulis setiap keluarga terpakai di mana sahaja ia dilayani, dan halaman perbandingan polisi merangkumi itu secara fakta.