Narratium custom API setup: base URL, key, at model.
Updated 2026-07-29
Ang Narratium ay isang open-source na roleplay at storytelling client na may sariling interface pero walang sariling models: itinuturo ng README nito ang mga user sa OpenAI-format APIs, OpenRouter-style unified endpoints, at lokal na Ollama. Ituro ang API settings nito sa https://api.apisrouter.com/v1 gamit ang isang key at ang buong katalogo ay magiging backend nito. Isang bagay na malinaw na sinasabi ng pahinang ito na nilalaktawan ng karamihan ng mga gabay: archived na ang GitHub repository, kaya patakbuhin ito nang alam mo na ang katotohanang iyon.
Mabilisang sagot: ang mga value na kailangan ng Narratium.
Ang LLM connection ng Narratium ay ang standard na OpenAI-compatible triple, ipinapasok sa API settings nito: isang base URL, isang API key, at isang model name. Para sa gateway na ito, iyon ay https://api.apisrouter.com/v1, ang iyong sk-... key, at anumang catalog id, na ang deepseek-v4-flash ang makatwirang unang pili para sa story traffic. Inirerekomenda ng README ng proyekto ang eksaktong klaseng ito ng koneksyon: OpenAI-format APIs nang direkta, isang unified multi-model endpoint para sa variety, o Ollama at LM Studio para sa mga lokal na model, lahat sa pamamagitan ng parehong configuration surface. Nag-iiba ang eksaktong field label sa pagitan ng web build at mga bersyon, kaya ituring nang maluwag ang mga label pero eksakto ang mga value: nagtatapos ang URL sa /v1, malinis na nade-paste ang key, tumutugma ang model id sa catalog string nang character for character.
Base URL: https://api.apisrouter.com/v1
API key: sk-... (from APIsRouter)
Model: deepseek-v4-flash (typed exactly; any catalog id works)Ano ang Narratium, at ang status nito, sinabi nang malinaw.
Ang Narratium (Narratium/Narratium.ai sa GitHub) ay ipinakilala ang sarili bilang VSCode para sa roleplay: isang open-source client para sa AI-driven storytelling, worldbuilding, at long-form interactive fiction, na may SillyTavern character card compatibility, memory persistence, at isang plugin system. AGPL-licensed ang code, mabilis itong nakakuha ng tunay na community, at nananatili itong isa sa mas kawili-wiling open client sa scene. Ngayon, ang bahaging nilalaktawan ng karamihan ng setup guide: archived at read-only na ang GitHub repository (ipinapakita ng GitHub na March 30, 2026 ang archive date). Ang archived ay hindi nangangahulugang sira, tumatakbo ang code nang kasing-galing ng araw na na-freeze ito, ngunit ibig sabihin nito ay walang maintainer na nagpapadala ng fixes, dependency update, o security patch, at ang mga hosted instance na kaugnay sa proyekto ay dapat ituring na best-effort na lamang. Kung aadaptahin mo ngayon ang Narratium, ang maaasahang ruta ay ang pagpapatakbo nito mula sa source o release, at ang makatotohanang inaasahan ay isang nakapirming feature set. Binabago ng status na iyon ang payo sa API sa isang tiyak na paraan: ang isang nakapirming client ay eksaktong sitwasyon kung saan gusto mong manatiling flexible ang panig ng model. Hindi na makakadagdag ang Narratium ng mga bagong provider integration, ngunit ang OpenAI-compatible endpoint na kausap na nito ay patuloy na nagse-serve ng anumang bagong model na lumalabas sa likod ng endpoint na iyon. Effectively, pinoprotektahan ng gateway pattern sa hinaharap ang isang client na hindi na gumagalaw.
Gabay sa setup.
Sinusunod ng troubleshooting ang universal na pattern: patunayan muna ang tatlong value gamit ang curl request, at kung gumana ang curl pero nabigo ang app, ang karaniwang dahilan ay isang URL na may ligaw na path segment, whitespace sa key, o CORS block ng browser sa mga web build, na makikita sa developer console. Dahil wala nang maintainer na magpapadala ng fix para sa mga app-side quirk, mas mahalaga ang ugaling curl-first dito: agad nitong sinasabi kung aling panig ng koneksyon ang talagang may magagawa ka.
- Patakbuhin ang Narratium: mag-self-host mula sa GitHub source o isang release (read-only ang repo pero fully cloneable pa rin), o gumamit ng hosted instance kung may pinagkakatiwalaan ka pa ring gumagana.
- Buksan ang settings at hanapin ang seksyon ng API / LLM configuration.
- Piliin ang OpenAI-format na connection type sa halip na Ollama, dahil nagtuturo ka sa isang hosted endpoint.
- Ilagay ang base URL na https://api.apisrouter.com/v1 at i-paste ang iyong key.
- I-type nang eksakto ang model id: deepseek-v4-flash para sa umpisa.
- I-save at magpadala ng isang maikling mensahe sa isang bagong story para kumpirmahin ang round trip.
Mga card, mundo, at ang nananatili kung aalis ka.
Nagbabasa ang Narratium ng mga character card na compatible sa SillyTavern, na siyang pinakamahalagang compatibility fact tungkol dito. Ang mga character mo ay portable na artifact: nag-i-import ang mga card na ginawa sa ibang lugar, at ang trabahong inilagay mo sa mga persona at world notes ay hindi nakakandado sa isang client na tumigil na ang development. Kung sakaling mag-migrate ka, magkatulad ang wika ng card ng SillyTavern, RisuAI, at Wyvern, at sakop ng mga setup page na naka-link sa ibaba ang bawat isa. Ang parehong lohika ng portability ay umaangkop din sa panig ng model. Dahil kausap ng Narratium ang isang generic na /v1 endpoint, walang bagay sa iyong provider setup na Narratium-specific: ang parehong key at base URL ay direktang gumagana sa anumang ibang frontend nang walang pagbabago. Sa pagitan ng portable na mga card at portable na endpoint, ang switching cost ng buong stack ay bumababa sa zero, na siyang tamang saloobin sa anumang archived na proyekto na natutuwa ka pa ring gamitin.
Mga model pick para sa long-form na istilo ng Narratium.
Nakasentro ang disenyo ng Narratium sa mahahabang branching narrative, kaya't tumitimbang ang pagpili ng model patungo sa consistency sa mahabang haba ng panahon. Dinadala ng deepseek-v4-flash ang pang-araw-araw na session sa pinakamababang rate ng katalogo na may dialogue na palaging pinapahalagahan ng roleplay community nang higit sa presyo nito. Umiikot ang glm-5.1 at kimi-k2.6 para sa variety ng boses, at kumikita ang glm-5.2 sa mga detalyadong kabanata kung saan mas malaki ang long-horizon instruction adherence nito kaysa sa reasoning latency nito. Nananatili ang claude-sonnet-4-6 bilang safe-for-work na kisame ng prose para sa mga kabanatang karapat-dapat dito. Dahil paulit-ulit na ipinapadala ng frontend ang story context sa bawat turn, dominante ang input token sa gastos, at higit na mainam ang isang sadyang working window kaysa sa isang maximal na window; kino-compute ito ng context-length guide na naka-link sa ibaba. Hindi nababago ang content policy dahil dito: umiiral ang model policies at ang applicable platform terms nang nakasulat, at sinasakop ng policies-compared page kung aling mga family ang bagay sa aling content rating, batay sa katotohanan.
Pay-as-you-go · mas mababa sa opisyal na presyo
Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.
| Model | Opisyal na Presyo | Aming Presyo |
|---|---|---|
| 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 |
Dapat mo bang i-adopt pa rin ang isang archived na client?
Isang tapat na cost-benefit, dahil ang setup guide pa rin ang pahinang ito kahit anong mangyari. Pabor: bukas ang code, talagang maganda ang interface para sa structured na long-form na mga kwento, portable ang mga card papasok at palabas, at pinananatili ng generic na endpoint na updated ang panig ng model magpakailanman. Laban: walang security patch, walang bug fix, tumatanda sa kinalalagyan ang mga dependency, at anumang hosted instance ay nabubuhay sa hiram na oras. Para sa isang hobby client na tumatakbo nang lokal laban sa isang metered key, katanggap-tanggap sa maraming tao ang risk profile na iyon; para sa anumang may ibang user o sensitibong data, hindi. Ang gitnang daan ay ang paulit-ulit na inilalarawan ng pahinang ito: patakbuhin ito mismo, panatilihin ang iyong investment sa mga portable na layer (mga card, lorebook, ang endpoint), at ituring na mapapalitan ang client. Dumarating at umaalis ang mga frontend sa scene na ito; isang kwentong suportado ng portable na mga card at isang matatag na /v1 endpoint ang mananatili nang higit sa lahat ng ito.
Mga madalas itanong
Paano ako magtatakda ng custom API base URL sa Narratium?
Sa API settings, piliin ang OpenAI-format na connection, pagkatapos ay ilagay ang base URL na https://api.apisrouter.com/v1, ang iyong key, at ang eksaktong model id tulad ng deepseek-v4-flash. Inirerekomenda ng README ang OpenAI-format APIs o isang unified multi-model endpoint, na siya ring eksaktong configuration na ito.
Maintained pa ba ang Narratium?
Hindi. Archived at read-only na ang GitHub repository (ipinapakita ng GitHub na March 30, 2026 ang archive date), kaya walang fix o update na ipinapadala. Tumatakbo pa rin ang code at cloneable pa rin ito; ang self-hosting ang maaasahang paraan para gamitin ito, na may inaasahang nakapirming feature set.
Gumagana ba ang Narratium sa mga character card ng SillyTavern?
Oo, ang compatibility sa format ng SillyTavern ay isa sa mga naka-document na feature nito, na nagpapanatiling portable sa magkabilang direksyon ang iyong mga character: nag-i-import ang mga card sa Narratium, at hindi masasayang ang trabaho mo kung lilipat ka sa SillyTavern, RisuAI, o Wyvern.
Aling mga model ang gumagana sa Narratium sa pamamagitan ng isang gateway?
Anuman ang na-serve ng endpoint, dahil ipinapadala ng Narratium ang pangalan ng model bilang plain string: deepseek-v4-flash at glm-5.1 para sa volume, kimi-k2.6 para sa rotation, glm-5.2 para sa mga detalyadong kabanata, claude-sonnet-4-6 para sa safe-for-work na prose. Isang pagbabago sa settings lamang ang paglipat, at nananatili sa client ang chat history.
Maaari ko bang patakbuhin ang Narratium nang ganap na lokal?
Oo, sa dalawang paraan: naka-self-host ang client mula sa archived na source, at pinapatakbo rin ng Ollama support nito ang mga model nang lokal. Ang hybrid na napagtatapusan ng karamihan ay isang lokal na client na may hosted endpoint sa likod nito, na nagpapanatili ng data handling sa iyong mga kamay habang naaabot ang mga model na hindi kayang i-serve ng anumang consumer GPU.
Labag ba sa anumang terms ang paggamit ng custom endpoint?
Open source ang Narratium at ginawa mismo para sa configuration na ito. Ang hindi kailanman binabago ng custom endpoint ay ang content policy sa panig ng model: umiiral ang nakasulat na patakaran ng bawat family kahit saan ito i-serve, at sinasakop ng policies-compared page ang mga iyon batay sa katotohanan.