Narratium 커스텀 API 설정: 베이스 URL, 키, 모델.

빠른 답: Narratium에 필요한 값.

Narratium의 LLM 연결은 API 설정에 입력하는 표준 OpenAI 호환 3종 세트입니다: 베이스 URL, API 키, 모델 이름. 이 게이트웨이의 경우 각각 https://api.apisrouter.com/v1, 여러분의 sk-... 키, 그리고 카탈로그의 아무 id입니다 — 스토리 트래픽에는 deepseek-v4-flash가 첫 선택으로 무난합니다. 프로젝트 README도 정확히 이런 부류의 연결을 권장합니다: OpenAI 형식 API를 직접 쓰거나, 다양성을 위한 통합 멀티 모델 엔드포인트를 쓰거나, 로컬 모델을 위한 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(GitHub의 Narratium/Narratium.ai)은 스스로를 '롤플레이용 VSCode'라고 소개했습니다: AI 기반 스토리텔링, 세계관 구축, 장편 인터랙티브 픽션을 위한 오픈소스 클라이언트로, SillyTavern 캐릭터 카드 호환, 메모리 지속, 플러그인 시스템을 갖추고 있습니다. 코드는 AGPL 라이선스이며, 빠르게 실제 커뮤니티를 끌어모았고, 지금도 이 분야에서 가장 흥미로운 오픈 클라이언트 중 하나로 남아 있습니다. 여기서 대부분의 설정 가이드가 빼먹는 부분입니다: GitHub 저장소는 아카이브되어 읽기 전용 상태입니다(GitHub에는 아카이브 날짜가 2026년 3월 30일로 표시됩니다). 아카이브되었다는 것이 고장 났다는 뜻은 아닙니다 — 코드는 동결된 그날과 똑같이 잘 작동합니다 — 하지만 어떤 메인테이너도 더 이상 수정, 의존성 업데이트, 보안 패치를 제공하지 않는다는 뜻이며, 이 프로젝트와 관련된 호스팅 인스턴스는 잘해봐야 '베스트 에포트' 수준으로 여겨야 합니다. 오늘 Narratium을 도입한다면, 소스나 릴리스에서 직접 실행하는 것이 믿을 만한 경로이며, 기능이 더 이상 늘어나지 않는다는 것을 현실적인 기대치로 삼아야 합니다. 이 상태는 API 관련 조언을 한 가지 구체적인 방식으로 바꿉니다: 동결된 클라이언트야말로 모델 쪽만큼은 유연하게 유지하고 싶은 상황입니다. Narratium은 더 이상 새로운 프로바이더 연동을 추가할 수 없지만, 이미 말할 줄 아는 OpenAI 호환 엔드포인트는 그 엔드포인트 뒤에 새로 등장하는 어떤 모델이든 계속 제공합니다. 게이트웨이 패턴은 사실상 더 이상 움직이지 않는 클라이언트를 미래에도 통하게 만들어 줍니다.

설정 안내.

문제 해결은 보편적인 패턴을 따릅니다: 먼저 curl 요청으로 세 값을 검증하고, curl은 성공하는데 앱이 실패한다면 흔한 원인은 URL에 잘못 붙은 경로 조각, 키에 섞인 공백, 또는 웹 빌드에서 개발자 콘솔에 보이는 브라우저 CORS 차단입니다. 앱 쪽의 사소한 문제를 고쳐줄 메인테이너가 더 이상 없기 때문에, 여기서는 curl을 먼저 시도하는 습관이 조금 더 중요합니다: 연결의 어느 쪽을 실제로 손볼 수 있는지 즉시 알려주기 때문입니다.

• Narratium을 먼저 실행하세요: GitHub 소스나 릴리스에서 셀프 호스팅하거나(저장소는 읽기 전용이지만 완전히 클론 가능합니다), 신뢰할 수 있는 호스팅 인스턴스가 아직 운영 중이라면 그것을 사용하세요.
• 설정을 열고 API / LLM 설정 섹션을 찾으세요.
• 호스팅된 엔드포인트를 사용할 것이므로 Ollama가 아니라 OpenAI 형식 연결 유형을 선택하세요.
• 베이스 URL로 https://api.apisrouter.com/v1을 입력하고 키를 붙여넣으세요.
• 모델 id를 정확히 입력하세요: 시작은 deepseek-v4-flash로.
• 저장한 다음 새 스토리에서 짧은 메시지 하나를 보내 왕복 통신을 확인하세요.

카드, 세계관, 떠나더라도 남는 것.

Narratium은 SillyTavern 호환 캐릭터 카드를 읽을 수 있는데, 이는 이 클라이언트에 관해 가장 중요한 호환성 사실입니다. 여러분의 캐릭터는 이식 가능한 산출물입니다: 다른 곳에서 작성된 카드도 가져올 수 있고, 페르소나와 세계관 노트에 들인 노력이 개발이 멈춘 클라이언트에 갇히지 않습니다. 나중에 이전하게 되더라도 SillyTavern, RisuAI, Wyvern 모두 같은 카드 계보를 사용하며, 아래 링크된 설정 페이지에서 각각을 다룹니다. 같은 이식성 논리가 모델 쪽에도 적용됩니다. Narratium은 범용 /v1 엔드포인트에 말을 걸기 때문에, 여러분의 프로바이더 설정 중 Narratium에만 특화된 것은 없습니다: 같은 키와 베이스 URL을 그대로 다른 프론트엔드에 넣을 수 있습니다. 이식 가능한 카드와 이식 가능한 엔드포인트 사이에서, 스택 전체를 옮기는 비용은 사실상 0에 가까워집니다 — 여전히 잘 쓰고 있는 아카이브된 프로젝트를 대하는 올바른 태도입니다.

Narratium의 장편 스타일에 맞는 모델 추천.

Narratium의 설계는 길게 가지를 치는 서사를 중심에 두므로, 모델 선택은 긴 흐름에서의 일관성에 무게를 둡니다. deepseek-v4-flash는 카탈로그 최저가로 일상 세션을 감당하며, 롤플레이 커뮤니티가 가격 대비 꾸준히 높게 평가하는 대화를 만들어냅니다. glm-5.1와 kimi-k2.6은 목소리 변화를 위해 돌아가며 쓰기 좋고, glm-5.2는 추론 지연보다 긴 흐름에서의 지시 준수가 더 중요한 디테일이 많은 챕터에서 제 몫을 합니다. claude-sonnet-4-6은 그럴 만한 가치가 있는 챕터를 위한 안전한(safe-for-work) 문장력의 최고봉으로 남아 있습니다. 프론트엔드가 매 턴마다 스토리 컨텍스트를 다시 보내기 때문에 입력 토큰이 비용을 좌우하며, 최대치가 아니라 의도적으로 정한 작업 윈도우가 더 낫습니다 — 아래 링크된 컨텍스트 길이 가이드가 그 계산을 다룹니다. 콘텐츠 정책은 이 모든 것과 무관하게 그대로입니다: 각 모델 정책과 적용되는 플랫폼 약관은 쓰여진 그대로 적용되며, 정책 비교 페이지가 어떤 패밀리가 어떤 콘텐츠 등급에 맞는지 사실 그대로 다룹니다.

사용한 만큼 지불 · 공식 요금보다 저렴

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

그래도 아카이브된 클라이언트를 도입해야 할까요?

이 페이지는 어차피 설정 가이드이므로, 정직한 비용-편익을 따져봅시다. 장점: 코드가 오픈소스이고, 구조화된 장편 스토리에 인터페이스가 실제로 훌륭하며, 카드는 양방향으로 이식 가능하고, 범용 엔드포인트 덕분에 모델 쪽은 영원히 최신 상태를 유지할 수 있습니다. 단점: 보안 패치도, 버그 수정도 없고, 의존성은 그 자리에서 낡아가며, 어떤 호스팅 인스턴스든 시한부로 운영됩니다. 종량제 키로 로컬에서 돌리는 취미용 클라이언트라면 이 리스크 수준은 많은 사람에게 받아들일 만하지만, 다른 사용자나 민감한 데이터가 얽힌 용도라면 그렇지 않습니다. 중간 길은 이 페이지가 처음부터 설명해온 바로 그것입니다: 직접 실행하고, 이식 가능한 레이어(카드, 로어북, 엔드포인트)에 투자를 집중하고, 클라이언트는 언제든 교체 가능한 것으로 취급하세요. 이 분야의 프론트엔드는 나타났다 사라지지만, 이식 가능한 카드와 안정적인 /v1 엔드포인트에 뒷받침된 스토리는 그 모두보다 오래 살아남습니다.

자주 묻는 질문