Кастомне налаштування API для Narratium: base URL, ключ, модель.

Updated 2026-07-29

Narratium — це клієнт з відкритим кодом для рольових ігор і сторітелінгу, який має власний інтерфейс, але жодних власних моделей: його README відсилає користувачів до API у форматі OpenAI, уніфікованих ендпоінтів у стилі OpenRouter і локального Ollama. Спрямуйте налаштування API на https://api.apisrouter.com/v1 з одним ключем — і весь каталог стає його бекендом. Одна річ, яку ця сторінка прямо називає, а більшість гайдів оминає: репозиторій на GitHub заархівований, тож використовуйте його, враховуючи цей факт.

Коротка відповідь: значення, потрібні Narratium.

З'єднання Narratium з LLM — це стандартна OpenAI-сумісна трійка значень, яку вводять у налаштуваннях API: base URL, API-ключ і назва моделі. Для цього шлюзу це https://api.apisrouter.com/v1, ваш ключ sk-... і будь-який ID з каталогу, причому deepseek-v4-flash — розумний перший вибір для історій. README проєкту рекомендує саме такий тип з'єднання: API у форматі OpenAI напряму, уніфікований мультимодельний ендпоінт для різноманіття або Ollama та LM Studio для локальних моделей — усе через одну й ту саму поверхню налаштувань. Точні назви полів різняться між веб-збіркою і версіями, тож ставтесь до назв вільно, а до значень — точно: URL закінчується на /v1, ключ вставляється без сторонніх символів, ID моделі збігається з рядком каталогу символ у символ.

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

Що таке Narratium і який у нього статус, прямо.

Narratium (Narratium/Narratium.ai на GitHub) позиціонував себе як «VSCode для рольових ігор»: клієнт з відкритим кодом для сторітелінгу на основі ШІ, побудови світів і довгих інтерактивних історій, із сумісністю з картками персонажів SillyTavern, збереженням пам'яті та системою плагінів. Код ліцензовано за AGPL, проєкт швидко зібрав справжню спільноту і залишається одним з найцікавіших відкритих клієнтів у цій ніші. А тепер частина, яку оминає більшість гайдів із налаштування: репозиторій на GitHub заархівований і доступний лише для читання (GitHub показує датою архівації 30 березня 2026 року). Заархівований не означає «зламаний» — код працює точно так само добре, як і в день заморозки, — але це означає, що жоден мейнтейнер більше не випускає виправлень, оновлень залежностей чи патчів безпеки, а хостингові інстанції, пов'язані з проєктом, варто сприймати щонайбільше як «best-effort». Якщо ви обираєте Narratium сьогодні, надійний шлях — запускати його самостійно з вихідного коду чи релізу, а реалістичне очікування — заморожений набір функцій. Цей статус змінює пораду щодо API в одному конкретному сенсі: заморожений клієнт — це якраз та ситуація, де ви хочете, щоб бік моделей лишався гнучким. Narratium більше не може додавати нові інтеграції з провайдерами, але OpenAI-сумісний ендпоінт, яким він уже вміє користуватись, продовжує обслуговувати будь-які нові моделі, що з'являються за цим ендпоінтом. Патерн шлюзу фактично захищає від застарівання клієнт, який більше не розвивається.

Покрокове налаштування.

Усунення несправностей йде за універсальним шаблоном: спершу підтвердіть три значення запитом curl, і якщо curl спрацював, а застосунок — ні, зазвичай винні зайвий сегмент шляху в URL, пробіли в ключі або блокування CORS браузером у веб-збірках, яке видно в консолі розробника. Оскільки жоден мейнтейнер більше не випустить виправлення для примх на боці застосунку, звичка спершу перевіряти curl тут особливо важлива: вона одразу показує, на якому боці з'єднання ви взагалі можете щось змінити.

  • Запустіть Narratium: самостійний хостинг з вихідного коду GitHub чи релізу (репозиторій доступний лише для читання, але повністю клонується), або використайте хостингову інстанцію, якщо їй довіряєте і вона ще працює.
  • Відкрийте налаштування і знайдіть розділ конфігурації API / LLM.
  • Оберіть тип з'єднання у форматі OpenAI, а не Ollama, оскільки ви підключаєтесь до хостингового ендпоінта.
  • Введіть base URL https://api.apisrouter.com/v1 і вставте ваш ключ.
  • Введіть ID моделі точно: для початку — deepseek-v4-flash.
  • Збережіть і надішліть одне коротке повідомлення в новій історії, щоб підтвердити зв'язок.

Картки, світи і що виживе, якщо ви підете.

Narratium читає картки персонажів, сумісні з SillyTavern, і це найважливіший факт про його сумісність. Ваші персонажі — портативні артефакти: картки, написані деінде, імпортуються, і робота, вкладена в персон і нотатки світу, не прив'язана до клієнта, розробка якого зупинилась. Якщо колись мігруватимете, SillyTavern, RisuAI і Wyvern усі говорять тією самою «мовою» карток, і сторінки з налаштуванням, на які є посилання нижче, охоплюють кожен з них. Та сама логіка портативності стосується і боку моделей. Оскільки Narratium звертається до звичайного ендпоінта /v1, у вашому налаштуванні провайдера немає нічого специфічного для Narratium: той самий ключ і base URL підставляються в будь-який інший фронтенд без змін. Завдяки портативним карткам і портативному ендпоінту вартість переходу на весь стек фактично дорівнює нулю — і це правильна позиція щодо будь-якого заархівованого проєкту, яким ви все ще залюбки користуєтесь.

Вибір моделей під довгоформатний стиль Narratium.

Дизайн Narratium зосереджений на довгих розгалужених наративах, тож вибір моделі зміщується у бік узгодженості на довгій дистанції. deepseek-v4-flash тягне повсякденні сесії за найнижчими тарифами каталогу з діалогами, які спільнота рольових ігор послідовно оцінює вище за їхню ціну. glm-5.1 і kimi-k2.6 чергуються заради різноманіття голосів, а glm-5.2 виправдовує себе в насичених деталями розділах, де її дотримання інструкцій на довгій дистанції переважає над затримкою міркування. claude-sonnet-4-6 лишається стелею SFW-прози для розділів, які на це заслуговують. Оскільки фронтенд повторно надсилає контекст історії на кожному ході, вхідні токени домінують у вартості, а свідомо обране робоче вікно вигідніше за максимальне; гайд з довжини контексту за посиланням нижче наводить розрахунки. Політика контенту від усього цього не змінюється: політики моделей і чинні умови платформи діють так, як написані, а сторінка порівняння політик фактично показує, які родини моделей підходять під які рейтинги контенту.

Оплата за фактом · нижче офіційних цін

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

МодельОфіційна цінаНаша ціна
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

Чи варто досі обирати заархівований клієнт?

Чесний аналіз витрат і вигід, адже ця сторінка все одно є гайдом з налаштування. За: код відкритий, інтерфейс справді хороший для структурованих довгих історій, картки портативні в обидва боки, а звичайний ендпоінт назавжди тримає бік моделей актуальним. Проти: жодних патчів безпеки, жодних виправлень багів, залежності старіють на місці, а будь-яка хостингова інстанція живе в борг часу. Для хобі-клієнта, що працює локально з ключем, оплаченим за фактичне використання, такий профіль ризику прийнятний для багатьох; для чогось з іншими користувачами чи чутливими даними — ні. Середній шлях — той, який ця сторінка описувала весь час: запускайте його самостійно, тримайте свої вкладення в портативних шарах (картки, лорбуки, ендпоінт) і ставтесь до клієнта як до змінного. Фронтенди в цій ніші приходять і йдуть; історія, підкріплена портативними картками і стабільним ендпоінтом /v1, переживе їх усі.

Поширені запитання

Як налаштувати кастомний base URL API в Narratium?

У налаштуваннях API оберіть з'єднання у форматі OpenAI, тоді введіть base URL https://api.apisrouter.com/v1, ваш ключ і точний ID моделі, наприклад deepseek-v4-flash. README рекомендує саме API у форматі OpenAI або уніфікований мультимодельний ендпоінт — це і є така конфігурація.

Чи підтримується Narratium досі?

Ні. Репозиторій на GitHub заархівований і доступний лише для читання (GitHub показує датою архівації 30 березня 2026 року), тож жодних виправлень чи оновлень не випускається. Код все ще працює і залишається клонованим; самостійний хостинг — надійний спосіб ним користуватись, з очікуванням щодо замороженого набору функцій.

Чи працює Narratium з картками персонажів SillyTavern?

Так, сумісність карток з форматом SillyTavern — одна з задокументованих функцій, яка тримає ваших персонажів портативними в обидва боки: картки імпортуються в Narratium, а ваша робота не залишиться «на мілині», якщо пізніше ви перейдете на SillyTavern, RisuAI чи Wyvern.

Які моделі працюють з Narratium через шлюз?

Будь-яка модель, яку обслуговує ендпоінт, оскільки Narratium надсилає назву моделі як звичайний рядок: deepseek-v4-flash і glm-5.1 для обсягу, kimi-k2.6 для ротації, glm-5.2 для насичених деталями розділів, claude-sonnet-4-6 для SFW-прози. Перемикання — це просто зміна налаштувань, а історія чату лишається в клієнті.

Чи можу я запустити Narratium повністю локально?

Так, у двох сенсах: клієнт можна самостійно розгорнути із заархівованого коду, а його підтримка Ollama також запускає моделі локально. Гібрид, на якому зупиняється більшість людей, — це локальний клієнт з хостинговим ендпоінтом за ним, що тримає обробку даних у ваших руках, водночас надаючи доступ до моделей, які не потягне жодна споживацька відеокарта.

Чи порушує використання кастомного ендпоінта якісь умови?

Narratium — з відкритим кодом і побудований саме під таку конфігурацію. Чого кастомний ендпоінт ніколи не змінює — це політику контенту на боці моделі: письмові правила кожної родини моделей діють незалежно від того, звідки її обслуговують, а сторінка порівняння політик фактично це висвітлює.