Własna konfiguracja API w Narratium: base URL, klucz, model.
Updated 2026-07-29
Narratium to open-source'owy klient do roleplayu i tworzenia opowieści, który dostarcza własny interfejs, ale żadnych własnych modeli: jego README kieruje użytkowników do API w formacie OpenAI, zunifikowanych endpointów w stylu OpenRouter oraz lokalnego Ollama. Wskaż jego ustawienia API na https://api.apisrouter.com/v1 z jednym kluczem, a cały katalog stanie się jego backendem. Jedna rzecz, o której ta strona mówi wprost, a większość poradników pomija: repozytorium na GitHubie jest zarchiwizowane, więc uruchamiaj go, mając ten fakt na uwadze.
Szybka odpowiedź: wartości, których potrzebuje Narratium.
Połączenie Narratium z LLM to standardowa trójka kompatybilna z OpenAI, wpisywana w jego ustawieniach API: base URL, klucz API i nazwa modelu. Dla tej bramki są to https://api.apisrouter.com/v1, Twój klucz sk-... oraz dowolny identyfikator z katalogu, przy czym deepseek-v4-flash to rozsądny pierwszy wybór do ruchu związanego z opowieściami. README projektu poleca dokładnie tę klasę połączenia: bezpośrednio API w formacie OpenAI, zunifikowany endpoint multi-model dla różnorodności, albo Ollama i LM Studio dla modeli lokalnych — wszystko przez tę samą powierzchnię konfiguracji. Dokładne etykiety pól różnią się między wersją webową a kolejnymi wydaniami, więc traktuj nazwy pól swobodnie, a wartości dokładnie: URL kończy się na /v1, klucz wklejasz bez dodatkowych znaków, a identyfikator modelu zgadza się z ciągiem z katalogu znak w znak.
Base URL: https://api.apisrouter.com/v1
API key: sk-... (from APIsRouter)
Model: deepseek-v4-flash (typed exactly; any catalog id works)Czym jest Narratium i jaki ma status — powiedziane wprost.
Narratium (Narratium/Narratium.ai na GitHubie) reklamowało się jako „VSCode dla roleplayu": open-source'owy klient do prowadzonego przez AI storytellingu, worldbuildingu i długoformowej fikcji interaktywnej, ze zgodnością z kartami postaci SillyTavern, trwałą pamięcią i systemem pluginów. Kod jest na licencji AGPL, szybko przyciągnął prawdziwą społeczność i pozostaje jednym z ciekawszych otwartych klientów w tej scenie. Teraz część, którą pomija większość poradników konfiguracji: repozytorium na GitHubie jest zarchiwizowane i tylko do odczytu (GitHub podaje datę archiwizacji jako 30 marca 2026). Zarchiwizowane nie znaczy zepsute — kod działa dokładnie tak samo dobrze jak w dniu zamrożenia — ale oznacza, że żaden maintainer nie wydaje poprawek, aktualizacji zależności ani łatek bezpieczeństwa, a hostowane instancje powiązane z projektem należy traktować co najwyżej jako „najlepszy możliwy wysiłek". Jeśli decydujesz się dziś na Narratium, pewną drogą jest uruchomienie go samodzielnie ze źródła albo z wydania (release), a realistycznym oczekiwaniem jest zamrożony zestaw funkcji. Ten status zmienia poradę dotyczącą API w jeden konkretny sposób: zamrożony klient to dokładnie sytuacja, w której zależy Ci na elastyczności po stronie modeli. Narratium nie może już dodawać integracji z nowymi dostawcami, ale endpoint kompatybilny z OpenAI, którym już mówi, wciąż obsługuje dowolne nowe modele pojawiające się za tym endpointem. Wzorzec bramki skutecznie zabezpiecza na przyszłość klienta, który już się nie rozwija.
Przewodnik po konfiguracji.
Rozwiązywanie problemów przebiega według uniwersalnego wzorca: najpierw sprawdź trzy wartości zapytaniem curl, a jeśli curl działa, a aplikacja nie, zwykli winowajcy to URL z przypadkowym dodatkowym segmentem ścieżki, białe znaki w kluczu albo blokada CORS w przeglądarce w wersjach webowych, widoczna w konsoli deweloperskiej. Ponieważ żaden maintainer nie wyda już poprawki na dziwactwa po stronie aplikacji, nawyk „najpierw curl" ma tu nieco większe znaczenie: od razu mówi Ci, na którą stronę połączenia rzeczywiście masz wpływ.
- Uruchom Narratium: hostuj samodzielnie ze źródła na GitHubie albo z release'u (repozytorium jest tylko do odczytu, ale w pełni można je sklonować), albo skorzystaj z hostowanej instancji, jeśli zaufana wciąż działa.
- Otwórz ustawienia i znajdź sekcję konfiguracji API / LLM.
- Wybierz typ połączenia w formacie OpenAI, a nie Ollama, ponieważ wskazujesz na hostowany endpoint.
- Wpisz base URL https://api.apisrouter.com/v1 i wklej swój klucz.
- Wpisz dokładnie identyfikator modelu: na początek deepseek-v4-flash.
- Zapisz i wyślij jedną krótką wiadomość w nowej historii, żeby potwierdzić działanie połączenia.
Karty, światy i co przetrwa, jeśli odejdziesz.
Narratium odczytuje karty postaci zgodne z SillyTavern, co jest najważniejszym faktem dotyczącym jego zgodności. Twoje postacie to przenośne artefakty: karty napisane gdzie indziej importują się bez problemu, a praca włożona w persony i notatki o świecie nie jest zamknięta w kliencie, którego rozwój się zatrzymał. Jeśli kiedykolwiek zmigrujesz, SillyTavern, RisuAI i Wyvern posługują się tą samą linią kart, a strony konfiguracji podlinkowane poniżej opisują każdy z nich. Ta sama logika przenośności dotyczy strony modeli. Ponieważ Narratium komunikuje się z ogólnym endpointem /v1, nic w Twojej konfiguracji dostawcy nie jest specyficzne dla Narratium: ten sam klucz i base URL wchodzą bez zmian do dowolnego innego frontendu. Między przenośnymi kartami a przenośnym endpointem koszt zmiany całego stacku zaokrągla się do zera, co jest właściwą postawą wobec każdego zarchiwizowanego projektu, którego wciąż lubisz używać.
Dobór modeli do długoformowego stylu Narratium.
Projekt Narratium skupia się na długich, rozgałęziających się narracjach, co przechyla wybór modelu w stronę spójności w długim horyzoncie. deepseek-v4-flash obsługuje codzienne sesje w najniższych stawkach katalogu, z dialogami, które społeczność roleplayowa konsekwentnie ocenia powyżej ich ceny. glm-5.1 i kimi-k2.6 wchodzą do rotacji dla różnorodności głosu, a glm-5.2 zarabia na rozdziały bogate w szczegóły, gdzie jego trzymanie się instrukcji w długim horyzoncie przeważa nad opóźnieniem wynikającym z rozumowania. claude-sonnet-4-6 pozostaje sufitem prozy safe-for-work dla rozdziałów, które na to zasługują. Ponieważ frontend przy każdej turze wysyła ponownie kontekst historii, tokeny wejściowe dominują koszt, a świadomie dobrane okno robocze bije maksymalne; przewodnik po długości kontekstu podlinkowany poniżej pokazuje te wyliczenia. Nic z tego nie zmienia polityki treści: polityki modeli i obowiązujące regulaminy platform obowiązują tak, jak są zapisane, a strona porównująca polityki opisuje rzeczowo, które rodziny modeli pasują do jakich ocen treści.
Płatność za użycie · poniżej cen oficjalnych
Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.
| Model | Cena oficjalna | Nasza cena |
|---|---|---|
| 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 |
Czy warto mimo to korzystać z zarchiwizowanego klienta?
Uczciwy bilans zysków i strat, skoro ta strona i tak jest przewodnikiem konfiguracji. Za: kod jest otwarty, interfejs jest naprawdę dobry do uporządkowanych, długoformowych opowieści, karty są przenośne w obie strony, a ogólny endpoint utrzymuje stronę modeli na bieżąco na zawsze. Przeciw: brak łatek bezpieczeństwa, brak poprawek błędów, starzejące się w miejscu zależności i każda hostowana instancja żyjąca na pożyczonym czasie. Dla hobbystycznego klienta uruchamianego lokalnie na rozliczanym, mierzonym kluczu ten profil ryzyka jest do zaakceptowania dla wielu osób; dla czegokolwiek z innymi użytkownikami albo wrażliwymi danymi — nie. Droga pośrednia to ta, którą ta strona opisuje od początku: uruchom go samodzielnie, trzymaj swoją inwestycję w warstwach przenośnych (karty, lorebooki, endpoint) i traktuj klienta jako wymienny. Frontendy w tej scenie przychodzą i odchodzą; historia oparta na przenośnych kartach i stabilnym endpoincie /v1 przetrwa je wszystkie.
Częste pytania
Jak ustawić niestandardowy base URL API w Narratium?
W ustawieniach API wybierz połączenie w formacie OpenAI, a następnie wpisz base URL https://api.apisrouter.com/v1, swój klucz i dokładny identyfikator modelu, np. deepseek-v4-flash. README poleca API w formacie OpenAI albo zunifikowany endpoint multi-model — dokładnie tę konfigurację.
Czy Narratium jest wciąż rozwijane?
Nie. Repozytorium na GitHubie jest zarchiwizowane i tylko do odczytu (GitHub podaje 30 marca 2026 jako datę archiwizacji), więc żadne poprawki ani aktualizacje nie są już wydawane. Kod nadal działa i wciąż można go sklonować; samodzielne hostowanie to pewny sposób korzystania z niego, z oczekiwaniami ustawionymi na zamrożony zestaw funkcji.
Czy Narratium działa z kartami postaci SillyTavern?
Tak, zgodność kart z formatem SillyTavern to jedna z jego udokumentowanych funkcji, dzięki czemu Twoje postacie są przenośne w obie strony: karty importują się do Narratium, a Twoja praca nie zostaje uwięziona, jeśli później przeniesiesz się do SillyTavern, RisuAI albo Wyvern.
Które modele działają z Narratium przez bramkę?
Wszystko, co obsługuje endpoint, ponieważ Narratium wysyła nazwę modelu jako zwykły string: deepseek-v4-flash i glm-5.1 do dużej objętości, kimi-k2.6 do rotacji, glm-5.2 do rozdziałów bogatych w szczegóły, claude-sonnet-4-6 do prozy safe-for-work. Zmiana to tylko zmiana ustawień, a historia czatu zostaje przy kliencie.
Czy mogę uruchomić Narratium w pełni lokalnie?
Tak, w dwóch sensach: klienta można hostować samodzielnie z zarchiwizowanego źródła, a jego wsparcie dla Ollama również uruchamia modele lokalnie. Hybryda, na której ludzie najczęściej się zatrzymują, to lokalny klient z hostowanym endpointem za nim, co zostawia obsługę danych w Twoich rękach, a jednocześnie daje dostęp do modeli, których nie obsłuży żaden konsumencki GPU.
Czy użycie niestandardowego endpointu narusza jakiś regulamin?
Narratium jest open source i zbudowane dokładnie pod tę konfigurację. Czego niestandardowy endpoint nigdy nie zmienia, to polityka treści po stronie modelu: spisane zasady każdej rodziny modeli obowiązują niezależnie od tego, skąd są obsługiwane, a strona porównująca polityki opisuje to rzeczowo.