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

Короткий ответ: какие значения нужны 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.

Стоит ли вообще брать в работу заархивированный клиент?

Честное соотношение выгод и издержек, ведь эта страница всё равно остаётся гайдом по настройке. За: код открыт, интерфейс по-настоящему хорош для структурированных длинных историй, карточки переносимы в обе стороны, а обобщённый эндпоинт держит сторону моделей вечно актуальной. Против: нет патчей безопасности, нет исправлений багов, зависимости стареют на месте, а любой хостед-инстанс живёт взаймы. Для хобби-клиента, запущенного локально против тарифицируемого ключа, такой профиль риска приемлем для многих; для чего-либо с другими пользователями или чувствительными данными — нет.

Средний путь — тот самый, что эта страница описывала всё время: запускайте сами, держите инвестиции в переносимых слоях (карточки, лорбуки, эндпоинт) и относитесь к клиенту как к заменяемому. Фронтенды в этой нише приходят и уходят; история, опирающаяся на переносимые карточки и стабильный эндпоинт /v1, переживёт их все.

Частые вопросы