Setup API kustom Narratium: base URL, key, model.

Updated 2026-07-29

Narratium adalah client roleplay dan storytelling open-source yang membawa interface-nya sendiri tanpa model sendiri: README-nya mengarahkan pengguna ke API format OpenAI, endpoint terpadu bergaya OpenRouter, dan Ollama lokal. Arahkan pengaturan API-nya ke https://api.apisrouter.com/v1 dengan satu key dan seluruh katalog menjadi backend-nya. Satu hal yang dinyatakan halaman ini secara jelas dan sering dilewatkan panduan lain: repository GitHub-nya sudah archived, jadi jalankan dengan fakta ini diperhitungkan.

Jawaban singkat: nilai yang dibutuhkan Narratium.

Koneksi LLM Narratium adalah tripel standar OpenAI-compatible, dimasukkan di pengaturan API-nya: base URL, API key, dan nama model. Untuk gateway ini nilainya adalah https://api.apisrouter.com/v1, key sk-... Anda, dan id katalog apa pun, dengan deepseek-v4-flash sebagai pilihan pertama yang masuk akal untuk traffic story. README proyek merekomendasikan tepat kelas koneksi ini: API format OpenAI langsung, endpoint multi-model terpadu untuk variasi, atau Ollama dan LM Studio untuk model lokal, semuanya melalui permukaan konfigurasi yang sama. Label field persis bervariasi antara build web dan versi, jadi perlakukan label secara longgar dan nilai secara persis: URL berakhir di /v1, key ditempel bersih, id model cocok dengan string katalog karakter demi karakter.

Base URL:  https://api.apisrouter.com/v1
API key:   sk-...              (dari APIsRouter)
Model:     deepseek-v4-flash   (ditulis persis; id katalog apa pun berfungsi)

Apa itu Narratium, dan statusnya, dinyatakan secara jelas.

Narratium (Narratium/Narratium.ai di GitHub) memposisikan dirinya sebagai VSCode untuk roleplay: client open-source untuk storytelling berbasis AI, worldbuilding, dan fiksi interaktif long-form, dengan kompatibilitas character card SillyTavern, persistensi memori, dan sistem plugin. Kodenya berlisensi AGPL, dengan cepat menarik komunitas nyata, dan tetap menjadi salah satu client open yang lebih menarik di scene ini. Sekarang bagian yang dilewatkan kebanyakan panduan setup: repository GitHub-nya archived dan read-only (GitHub menunjukkan tanggal archive sebagai 30 Maret 2026). Archived tidak berarti rusak, kodenya berjalan sama baiknya seperti hari dibekukan, tapi berarti tidak ada maintainer yang mengirim fix, update dependency, atau patch keamanan, dan instance hosted yang terkait dengan proyek ini sebaiknya dianggap best-effort paling banter. Jika Anda mengadopsi Narratium hari ini, rute yang bisa diandalkan adalah menjalankannya sendiri dari source atau release, dan ekspektasi realistisnya adalah feature set yang beku. Status itu mengubah saran API dengan satu cara spesifik: client yang beku justru situasi tepat di mana Anda ingin sisi model tetap fleksibel. Narratium tidak bisa lagi menambah integrasi provider baru, tapi endpoint OpenAI-compatible yang sudah dipahaminya terus melayani model baru apa pun yang muncul di belakang endpoint itu. Pola gateway ini secara efektif membuat client yang sudah tidak bergerak lagi menjadi future-proof.

Panduan setup.

Troubleshooting mengikuti pola universal: buktikan tiga nilai dengan request curl dulu, dan jika curl berhasil sementara app gagal, penyebab biasanya adalah URL dengan segmen path nyasar, whitespace di key, atau blokir CORS browser pada build web, yang terlihat di developer console. Karena tidak ada maintainer yang akan mengirim fix untuk quirk sisi app lagi, kebiasaan curl-first sedikit lebih penting di sini: ia langsung memberi tahu Anda sisi koneksi mana yang sebenarnya bisa Anda tangani.

  • Jalankan Narratium: self-host dari source GitHub atau release (repo read-only tapi sepenuhnya bisa di-clone), atau gunakan instance hosted jika ada yang masih Anda percaya beroperasi.
  • Buka pengaturan dan cari bagian konfigurasi API / LLM.
  • Pilih tipe koneksi format OpenAI, bukan Ollama, karena Anda mengarah ke endpoint hosted.
  • Masukkan base URL https://api.apisrouter.com/v1 dan tempel key Anda.
  • Ketik id model persis: deepseek-v4-flash untuk mulai.
  • Simpan dan kirim satu pesan singkat di story baru untuk konfirmasi round trip.

Card, dunia, dan apa yang bertahan jika Anda pergi.

Narratium membaca character card kompatibel SillyTavern, yang merupakan fakta kompatibilitas paling penting tentangnya. Karakter Anda adalah artefak portabel: card yang ditulis di tempat lain bisa di-import, dan kerja yang Anda tuangkan ke persona dan world notes tidak terkunci pada client yang pengembangannya sudah berhenti. Jika suatu saat Anda migrasi, SillyTavern, RisuAI, dan Wyvern semuanya berbicara lineage card yang sama, dan halaman setup yang ditautkan di bawah membahas masing-masing. Logika portabilitas yang sama berlaku pada sisi model. Karena Narratium berbicara ke endpoint /v1 generik, tidak ada yang spesifik-Narratium tentang setup provider Anda: key dan base URL yang sama masuk ke frontend lain tanpa perubahan. Antara card yang portabel dan endpoint yang portabel, biaya switching seluruh stack ini nyaris nol, yang merupakan sikap yang tepat terhadap proyek archived apa pun yang masih Anda nikmati penggunaannya.

Pilihan model untuk gaya long-form Narratium.

Desain Narratium berpusat pada narasi bercabang yang panjang, yang membobotkan pilihan model ke arah konsistensi dibanding horizon panjang. deepseek-v4-flash mengangkut sesi sehari-hari dengan tarif terendah di katalog dengan dialog yang secara konsisten dinilai komunitas roleplay di atas harganya. glm-5.1 dan kimi-k2.6 bergiliran untuk variasi suara, dan glm-5.2 pantas mendapat bab yang detail-heavy karena kepatuhan instruksinya pada horizon panjang lebih penting dari latensi reasoning-nya. claude-sonnet-4-6 tetap menjadi ceiling prosa safe-for-work untuk bab yang layak mendapatkannya. Karena frontend mengirim ulang context story setiap giliran, input token mendominasi biaya, dan working window yang disengaja mengalahkan yang maksimal; panduan panjang context yang ditautkan di bawah menghitung ini. Kebijakan konten tidak berubah oleh semua ini: kebijakan model dan syarat platform yang berlaku tetap berlaku sebagaimana tertulis, dan halaman perbandingan kebijakan membahas keluarga mana yang cocok dengan rating konten mana, secara faktual.

Bayar sesuai pemakaian · di bawah harga resmi

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

ModelHarga ResmiHarga 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

Haruskah Anda tetap mengadopsi client yang archived?

Cost-benefit yang jujur, karena halaman ini tetap menjadi panduan setup bagaimanapun juga. Yang mendukung: kodenya open, interface-nya benar-benar bagus untuk story long-form terstruktur, card portabel masuk-keluar, dan endpoint generik menjaga sisi model tetap up-to-date selamanya. Yang menentang: tidak ada patch keamanan, tidak ada perbaikan bug, dependency menua di tempat, dan instance hosted apa pun hidup dengan waktu pinjaman. Untuk client hobi yang berjalan lokal melawan key bermeter, profil risiko itu bisa diterima banyak orang; untuk apa pun dengan pengguna lain atau data sensitif, tidak. Jalan tengahnya adalah yang telah dijelaskan halaman ini sepanjang waktu: jalankan sendiri, pertahankan investasi Anda di lapisan portabel (card, lorebook, endpoint), dan perlakukan client sebagai bisa diganti. Frontend di scene ini datang dan pergi; story yang didukung card portabel dan endpoint /v1 yang stabil bertahan lebih lama dari semuanya.

Pertanyaan umum

Bagaimana cara mengatur base URL API kustom di Narratium?

Di pengaturan API, pilih koneksi format OpenAI, lalu masukkan base URL https://api.apisrouter.com/v1, key Anda, dan id model persis seperti deepseek-v4-flash. README merekomendasikan API format OpenAI atau endpoint multi-model terpadu, yang persis konfigurasi ini.

Apakah Narratium masih dipelihara?

Tidak. Repository GitHub-nya archived dan read-only (GitHub menunjukkan 30 Maret 2026 sebagai tanggal archive), jadi tidak ada fix atau update yang dikirim. Kodenya masih berjalan dan tetap bisa di-clone; self-hosting adalah cara yang bisa diandalkan untuk menggunakannya, dengan ekspektasi diatur ke feature set yang beku.

Apakah Narratium berfungsi dengan character card SillyTavern?

Ya, kompatibilitas card dengan format SillyTavern adalah salah satu fitur terdokumentasinya, yang menjaga karakter Anda portabel di kedua arah: card di-import ke Narratium, dan kerja Anda tidak terdampar jika suatu saat Anda pindah ke SillyTavern, RisuAI, atau Wyvern.

Model mana yang berfungsi dengan Narratium melalui gateway?

Apa pun yang dilayani endpoint, karena Narratium mengirim nama model sebagai string biasa: deepseek-v4-flash dan glm-5.1 untuk volume, kimi-k2.6 untuk rotasi, glm-5.2 untuk bab detail-heavy, claude-sonnet-4-6 untuk prosa safe-for-work. Beralih adalah perubahan pengaturan, dan riwayat chat tetap di client.

Bisakah saya menjalankan Narratium sepenuhnya lokal?

Ya, dalam dua pengertian: client-nya self-host dari source archived, dan dukungan Ollama-nya juga menjalankan model secara lokal. Hybrid yang dipilih kebanyakan orang adalah client lokal dengan endpoint hosted di baliknya, yang menjaga penanganan data di tangan Anda sambil menjangkau model yang tidak dilayani GPU konsumen mana pun.

Apakah menggunakan endpoint kustom melanggar syarat apa pun?

Narratium adalah open source dan dibangun tepat untuk konfigurasi ini. Yang tidak pernah diubah endpoint kustom adalah kebijakan konten sisi model: aturan tertulis setiap keluarga berlaku di mana pun ia dilayani, dan halaman perbandingan kebijakan membahas itu secara faktual.