Narratium aangepaste API-instelling: base URL, sleutel, model.

Updated 2026-07-29

Narratium is een open-source client voor roleplay en verhalen die een eigen interface meebrengt, maar geen eigen modellen: de README verwijst gebruikers naar API's in OpenAI-formaat, unified endpoints in OpenRouter-stijl en lokale Ollama. Wijs de API-instellingen naar https://api.apisrouter.com/v1 met één sleutel, en de hele catalogus wordt de backend. Eén ding dat deze pagina eerlijk vermeldt en de meeste handleidingen overslaan: de GitHub-repository is gearchiveerd, dus reken dat gegeven mee.

Snel antwoord: de waarden die Narratium nodig heeft.

De LLM-verbinding van Narratium is het standaard OpenAI-compatibele drietal, ingevoerd in de API-instellingen: een base URL, een API-sleutel en een modelnaam. Voor deze gateway zijn dat https://api.apisrouter.com/v1, je sk-...-sleutel en een willekeurig catalogus-ID, waarbij deepseek-v4-flash de voor de hand liggende eerste keuze is voor verhalend verkeer. De README van het project raadt precies dit type verbinding aan: rechtstreeks API's in OpenAI-formaat, een unified multi-model endpoint voor variatie, of Ollama en LM Studio voor lokale modellen, allemaal via hetzelfde configuratieoppervlak. Exacte veldlabels variëren tussen de webbuild en versies, dus behandel labels losjes en waarden exact: de URL eindigt op /v1, de sleutel plakt schoon, het model-ID komt teken voor teken overeen met de catalogusstring.

Base URL:  https://api.apisrouter.com/v1
API key:   sk-...              (from APIsRouter)
Model:     deepseek-v4-flash   (typed exactly; any catalog id works)

Wat Narratium is, en de status ervan, eerlijk gezegd.

Narratium (Narratium/Narratium.ai op GitHub) profileerde zich als de VSCode voor roleplay: een open-source client voor AI-gedreven verhalen, worldbuilding en lange interactieve fictie, met SillyTavern-character-card-compatibiliteit, geheugenpersistentie en een pluginsysteem. De code is AGPL-gelicentieerd, trok snel een echte community en blijft een van de interessantere open clients in de scene. Nu het deel dat de meeste instelhandleidingen overslaan: de GitHub-repository is gearchiveerd en alleen-lezen (GitHub toont 30 maart 2026 als archiveringsdatum). Gearchiveerd betekent niet kapot — de code draait precies zo goed als op de dag dat hij werd bevroren — maar het betekent dat geen enkele maintainer nog fixes, dependency-updates of beveiligingspatches uitbrengt, en dat de gehoste instanties van het project hooguit als best-effort moeten worden behandeld. Als je Narratium vandaag adopteert, is zelf draaien vanuit de bron of een release de betrouwbare route, met een bevroren featureset als realistische verwachting. Die status verandert het API-advies op één specifiek punt: een bevroren client is precies de situatie waarin je wilt dat de modelkant flexibel blijft. Narratium kan geen nieuwe providerintegraties meer toevoegen, maar een OpenAI-compatibel endpoint dat de client al spreekt, blijft elk nieuw model bedienen dat achter dat endpoint verschijnt. Het gateway-patroon maakt een client die niet meer beweegt effectief future-proof.

Stap voor stap instellen.

Problemen oplossen volgt het universele patroon: bewijs eerst de drie waarden met een curl-verzoek, en als curl slaagt terwijl de app faalt, zijn de gebruikelijke boosdoeners een URL met een overtollig padsegment, witruimte in de sleutel, of een CORS-blokkade in de browser bij webbuilds, zichtbaar in de developerconsole. Omdat geen enkele maintainer nog een fix uitbrengt voor eigenaardigheden aan de app-kant, telt de gewoonte om eerst curl te gebruiken hier extra: het vertelt je meteen aan welke kant van de verbinding je daadwerkelijk iets kunt doen.

  • Zorg dat Narratium draait: self-host vanaf de GitHub-bron of een release (de repo is alleen-lezen maar volledig te clonen), of gebruik een gehoste instantie als er een betrouwbare nog actief is.
  • Open de instellingen en zoek de API-/LLM-configuratiesectie.
  • Kies het verbindingstype in OpenAI-formaat in plaats van Ollama, aangezien je naar een gehost endpoint wijst.
  • Voer base URL https://api.apisrouter.com/v1 in en plak je sleutel.
  • Typ het model-ID exact: begin met deepseek-v4-flash.
  • Sla op en stuur één kort bericht in een nieuw verhaal om de round trip te bevestigen.

Kaarten, werelden, en wat overleeft als je vertrekt.

Narratium leest SillyTavern-compatibele character cards, en dat is verreweg het belangrijkste compatibiliteitsfeit. Je personages zijn draagbare artefacten: kaarten die elders geschreven zijn, importeren gewoon, en het werk dat je in persona's en wereldnotities steekt, zit niet vast aan een client waarvan de ontwikkeling is gestopt. Als je ooit migreert: SillyTavern, RisuAI en Wyvern spreken allemaal dezelfde kaartlijn, en de instelpagina's hieronder behandelen elk daarvan. Dezelfde portabiliteitslogica geldt voor de modelkant. Omdat Narratium met een generiek /v1-endpoint praat, is niets aan je providerinstelling Narratium-specifiek: dezelfde sleutel en base URL werken ongewijzigd in elke andere frontend. Tussen draagbare kaarten en een draagbaar endpoint rondt de overstapkost van de hele stack af op nul — en dat is de juiste houding tegenover elk gearchiveerd project dat je nog steeds graag gebruikt.

Modelkeuzes voor de lange verhaalstijl van Narratium.

Het ontwerp van Narratium draait om lange, vertakkende verhaallijnen, wat de modelkeuze laat doorslaan naar consistentie over lange trajecten. deepseek-v4-flash draagt alledaagse sessies tegen de laagste tarieven van de catalogus, met dialoog die de roleplay-community consequent boven zijn prijs waardeert. glm-5.1 en kimi-k2.6 rouleren mee voor stemvariatie, en glm-5.2 verdient detailrijke hoofdstukken waar zijn instructienaleving over lange trajecten opweegt tegen zijn redeneerlatentie. claude-sonnet-4-6 blijft het safe-for-work-prozaplafond voor hoofdstukken die dat verdienen. Omdat de frontend bij elke beurt de verhaalcontext opnieuw verstuurt, domineren inputtokens de kosten, en een bewust werkvenster verslaat een maximaal venster; de contextlengte-gids hieronder maakt de som. Het contentbeleid verandert door niets van dit alles: modelbeleid en toepasselijke platformvoorwaarden gelden zoals geschreven, en de pagina met beleidsvergelijking behandelt feitelijk welke families bij welke contentratings passen.

Betaal naar gebruik · onder officiële prijzen

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

ModelOfficiële prijsOnze prijs
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

Moet je nog steeds een gearchiveerde client adopteren?

Een eerlijke kosten-batenanalyse, want deze pagina is sowieso de instelhandleiding. Voor: de code is open, de interface is oprecht goed voor gestructureerde lange verhalen, kaarten zijn in en uit draagbaar, en een generiek endpoint houdt de modelkant voor altijd actueel. Tegen: geen beveiligingspatches, geen bugfixes, dependencies die ter plekke verouderen, en elke gehoste instantie die op geleende tijd leeft. Voor een hobbyclient die lokaal draait tegen een gemeten sleutel is dat risicoprofiel voor veel mensen acceptabel; voor iets met andere gebruikers of gevoelige data is dat niet zo. De middenweg is degene die deze pagina de hele tijd al beschrijft: draai het zelf, houd je investering in de draagbare lagen (kaarten, lorebooks, het endpoint), en behandel de client als vervangbaar. Frontends in deze scene komen en gaan; een verhaal dat steunt op draagbare kaarten en een stabiel /v1-endpoint overleeft ze allemaal.

Veelgestelde vragen

Hoe stel ik een aangepaste API base URL in Narratium in?

Kies in de API-instellingen de verbinding in OpenAI-formaat, voer dan base URL https://api.apisrouter.com/v1 in, je sleutel, en een exact model-ID zoals deepseek-v4-flash. De README raadt API's in OpenAI-formaat of een unified multi-model endpoint aan — precies deze configuratie.

Wordt Narratium nog onderhouden?

Nee. De GitHub-repository is gearchiveerd en alleen-lezen (GitHub toont 30 maart 2026 als archiveringsdatum), dus er worden geen fixes of updates meer uitgebracht. De code draait nog steeds en is nog te clonen; self-hosten is de betrouwbare manier om het te gebruiken, met een bevroren featureset als verwachting.

Werkt Narratium met SillyTavern-character-cards?

Ja, compatibiliteit met het SillyTavern-kaartformaat is een van de gedocumenteerde functies, wat je personages in beide richtingen draagbaar houdt: kaarten importeren in Narratium, en je werk raakt niet gestrand als je later naar SillyTavern, RisuAI of Wyvern overstapt.

Welke modellen werken met Narratium via een gateway?

Alles wat het endpoint bedient, aangezien Narratium de modelnaam als platte string verstuurt: deepseek-v4-flash en glm-5.1 voor volume, kimi-k2.6 voor rotatie, glm-5.2 voor detailrijke hoofdstukken, claude-sonnet-4-6 voor safe-for-work-proza. Overstappen is een instellingswijziging, en de chatgeschiedenis blijft bij de client.

Kan ik Narratium volledig lokaal draaien?

Ja, in twee betekenissen: de client is self-hosted vanaf de gearchiveerde bron, en de Ollama-ondersteuning draait modellen ook lokaal. De hybride waar de meeste mensen op uitkomen is een lokale client met een gehost endpoint erachter, wat gegevensverwerking in eigen hand houdt terwijl je modellen bereikt die geen consumenten-GPU aankan.

Is het gebruik van een aangepast endpoint in strijd met voorwaarden?

Narratium is open source en gebouwd voor precies deze configuratie. Wat een aangepast endpoint nooit verandert, is het contentbeleid aan modelzijde: de geschreven regels van elke familie gelden ongeacht vanwaar het model bediend wordt, en de pagina met beleidsvergelijking behandelt dat feitelijk.