Настройка кастомного API в Narratium: base URL, ключ, модель.

Updated 2026-07-29

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

Короткий ответ: какие значения нужны Narratium.

Подключение LLM в Narratium — это стандартная 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 для ролплея»: open-source клиент для сторителлинга на основе ИИ, worldbuilding и полноформатной интерактивной прозы, с совместимостью с карточками персонажей 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 — open source и создан именно для такой конфигурации. Что кастомный эндпоинт никогда не меняет — это политику контента на стороне модели: письменные правила каждого семейства действуют независимо от того, откуда модель обслуживается, а страница сравнения политик фактически их разбирает.