Narratium カスタム API 設定: ベース URL・キー・モデル。
Updated 2026-07-29
Narratium はオープンソースのロールプレイ・ストーリーテリング用クライアントで、独自のインターフェースを持つ一方、モデルは一切内蔵していません。README では OpenAI 形式の API、OpenRouter 型の統合エンドポイント、ローカルの Ollama への接続が案内されています。API 設定で https://api.apisrouter.com/v1 と1つのキーを指定するだけで、カタログ全体がそのままバックエンドになります。多くのガイドが触れない点をこのページははっきり述べます。GitHub リポジトリはすでにアーカイブされているため、その事実を織り込んだ上で運用してください。
早わかり: Narratium に必要な設定値。
Narratium の LLM 接続は、API 設定画面に入力する標準的な OpenAI 互換の3点セット、ベース URL・API キー・モデル名です。このゲートウェイの場合はそれぞれ https://api.apisrouter.com/v1、あなたの sk-... キー、そしてカタログ内の任意の id となり、ストーリー用途の最初の選択としては deepseek-v4-flash が無難です。プロジェクトの README はまさにこの種の接続を推奨しています。OpenAI 形式 API への直接接続、多様性のための統合マルチモデルエンドポイント、あるいはローカルモデル向けの Ollama や LM Studio まで、すべて同じ設定画面から扱えます。 正確なフィールド名は Web 版やバージョンによって多少異なるため、ラベルはおおまかに、値は正確に扱ってください。URL は /v1 で終わる、キーはそのまま貼り付ける、モデル id はカタログの文字列と一字一句一致させる、という3点が重要です。
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 リクエストで3つの値を検証し、curl は成功するのにアプリが失敗する場合、原因としてよくあるのは URL に余分なパスセグメントが入っている、キーに空白が混じっている、あるいは Web 版でブラウザの CORS がブロックしている(開発者コンソールで確認可能)、のいずれかです。アプリ側の癖に対する修正はもうメンテナーから提供されないため、まず curl で確認する習慣はここでは少し余計に重要です。接続のどちら側なら実際に自分で対処できるのかが、すぐにわかります。
- Narratium を動かす: GitHub のソースコードやリリース版からセルフホストする(リポジトリは読み取り専用ですが、クローン自体は問題なく行えます)、あるいは信頼できるホスティングインスタンスがまだ稼働していればそれを利用します。
- 設定を開き、API / LLM 設定のセクションを探します。
- ホスティングされたエンドポイントに接続するので、Ollama ではなく OpenAI 形式の接続タイプを選びます。
- ベース URL に https://api.apisrouter.com/v1 を入力し、キーを貼り付けます。
- モデル id を正確に入力します。まずは deepseek-v4-flash から。
- 保存し、新しいストーリーで短いメッセージを1件送って、正しく往復することを確認します。
カード、世界観、そして離れても残るもの。
Narratium は SillyTavern 互換のキャラクターカードを読み込めます。これがこのツールに関して最も重要な互換性の事実です。あなたのキャラクターは持ち運び可能な資産です。他所で作られたカードもインポートでき、ペルソナや世界観ノートに注いだ労力は、開発が止まったクライアントに縛られません。もし移行することになっても、SillyTavern、RisuAI、Wyvern はいずれも同じカードの系譜を話すので、下記のセットアップページでそれぞれをカバーしています。 この可搬性のロジックはモデル側にも同じく当てはまります。Narratium は汎用的な /v1 エンドポイントと話すだけなので、プロバイダー設定に Narratium 固有の部分は何もありません。同じキーとベース URL を、他のどのフロントエンドにもそのまま持ち込めます。持ち運べるカードと持ち運べるエンドポイントがそろえば、スタック全体の乗り換えコストはほぼゼロになります。これは、気に入って使い続けているアーカイブ済みプロジェクトに対する正しい向き合い方でもあります。
Narratium の長編スタイルに向くモデル選び。
Narratium の設計は長い分岐型の物語を中心としており、そのためモデル選びは長時間にわたる一貫性を重視したものになります。deepseek-v4-flash はカタログ最安クラスの料金で日常的なセッションを支え、その対話品質はロールプレイコミュニティから価格以上と評価され続けています。glm-5.1 と kimi-k2.6 は声色に変化をつけるためのローテーション枠で、glm-5.2 は長時間にわたる指示追従性が推論のレイテンシを上回る価値を持つため、描写の濃い章で力を発揮します。claude-sonnet-4-6 は、それに値する章のための、安全性の高い文章表現の到達点であり続けます。 フロントエンドはターンごとにストーリーの文脈を再送信するため、コストの大部分は入力トークンが占めます。意図的に絞った作業ウィンドウの方が、最大まで広げたウィンドウより有利で、その計算は下記のコンテキスト長ガイドで扱っています。コンテンツポリシーはここまでの話とは無関係に不変です。各モデルのポリシーと適用されるプラットフォーム規約はそのまま適用され、ポリシー比較ページでどのモデルファミリーがどのコンテンツレーティングに適合するかを事実ベースで解説しています。
従量課金 · 公式価格より安い
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 エンドポイントに支えられた物語は、そのすべてより長く生き残ります。
よくある質問
Narratium でカスタムの API ベース URL を設定するには?
API 設定で OpenAI 形式の接続を選び、ベース URL に https://api.apisrouter.com/v1、あなたのキー、そして deepseek-v4-flash のような正確なモデル id を入力します。README では OpenAI 形式 API や統合マルチモデルエンドポイントが推奨されていますが、まさにこの構成がそれに当たります。
Narratium は今もメンテナンスされていますか?
いいえ。GitHub リポジトリはアーカイブされ読み取り専用になっており(アーカイブ日は2026年3月30日と表示)、修正やアップデートは提供されていません。コードは今も動作し、クローンも可能です。使うなら自分でホストするのが確実な方法で、機能セットは凍結されたものと考えておいてください。
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。切り替えは設定変更だけで済み、チャット履歴はクライアント側にそのまま残ります。
Narratium を完全にローカルだけで動かせますか?
はい、2つの意味で可能です。クライアント自体はアーカイブされたソースからセルフホストでき、さらに Ollama 対応によりモデルもローカルで動かせます。多くの人が落ち着く形は、ローカルのクライアントの背後にホスティングされたエンドポイントを置くハイブリッド構成です。データの取り扱いは自分の手元に置きつつ、一般的な GPU では動かせないモデルにも手が届きます。
カスタムエンドポイントの利用は何らかの規約に違反しますか?
Narratium はオープンソースであり、まさにこの構成のために作られています。カスタムエンドポイントを使っても、モデル側のコンテンツポリシーだけは決して変わりません。各モデルファミリーの明文化されたルールはどこから提供されていても適用され、ポリシー比較ページで事実ベースにまとめています。