KoboldAI Lite を、カスタムの OpenAI 互換エンドポイントで。

早わかり: Lite に必要な設定値。

AI 接続パネル(Lite 上部メニューの AI ボタン)を開き、既定の AI Horde からカスタムエンドポイントのグループに切り替えて、OpenAI 互換のオプションを選びます。正確なラベルはビルドによって多少揺れますが、項目自体は一定です。API URL、キー、そして接続後に選ぶモデルの3つです。 これが失敗する原因のほとんどは、Lite 特有の2つの詳細に起因します。1つ目はバージョンのチェックボックスです。Lite には URL の末尾に自動で /v1 を付け足す「Add Ver. Num」のようなトグルがあり、そのチェックを入れて https://api.apisrouter.com、外して https://api.apisrouter.com/v1 と入力すればどちらも正しく解決されますが、/v1 を二重にすると解決されません。2つ目は永続化の問題です。Lite は再接続時にカスタムエンドポイントの URL をリセットしてしまうことが過去にあったため、フィールドが毎回のセッションで残っていると思い込まず、URL は手元にひかえておいてください。

API URL:  https://api.apisrouter.com/v1   (or base URL + "Add Ver. Num" ticked)
API key:  sk-...                            (from APIsRouter)
Model:    deepseek-v4-flash                 (or any catalog id after connecting)

Lite とは何か、そしてどうやってホスト型モデルに届くのか。

KoboldAI Lite は Kobold エコシステムの、インストール不要な Web UI です。ストーリー執筆、アドベンチャーモード、キャラクターチャットのすべてがブラウザの中だけで完結する単一ページアプリで、同じ設定を共有する2つの形態で提供されています。lite.koboldai.net のホスト版と、モデルをローカルで動かすときに KoboldCpp が localhost 上で配信する同梱版です。プロジェクトの README では、OpenAI 形式・Claude 形式の API を含むカスタムエンドポイント、ローカルおよびリモートの Kobold インスタンス、クラウドソースの AI Horde に接続できると説明されています。 Lite は自分自身のサーバーを持たないブラウザアプリなので、API リクエストはブラウザから設定したエンドポイントへ直接飛びます。この設計こそがカスタムエンドポイント経路を成立させている理由であり、同時に下記の CORS セクションが存在する理由でもあります。エンドポイントはブラウザオリジンのリクエストに応答する必要があり、応答しない場合のために Lite はトレードオフのあるプロキシトグルを用意しています(切り替える前に理解しておく価値があります)。 AI Horde から来た方へ: ボランティアクラスターに対する従量課金エンドポイントの魅力は「予測できること」です。Horde は本当に無料ですがキューがあり、資金のあるエンドポイントなら指定したモデルでただちに応答し、バリュー系ファミリーの料金なら一晩遊んでも1メッセージあたり1セントに満たない程度で済みます。

セットアップを項目ごとに。

接続後もモデルリストが空のままの場合、よくある原因の順は、/v1 の重複または欠落(まずバージョンチェックボックスを確認)、キーに空白が混じっている、ブラウザ拡張機能がリクエストをブロックしている、の3つです。同じ3つの値を curl コマンドで試して動くことを確認するのが、エンドポイント側は問題ないと証明してブラウザ側に問題を絞り込む一番速い方法です。

• Lite(ホスト版でも同梱版でも)を開き、上部メニューの AI ボタンをクリックして接続パネルを開きます。
• プロバイダーの選択を AI Horde からカスタムエンドポイントのグループに切り替え、OpenAI 互換のオプションを選びます(ラベルはビルドにより多少異なり、隣に Claude 形式のオプションが並んでいます)。
• URL に https://api.apisrouter.com/v1 を入力します。上記のバージョンチェックボックスに注意し、/v1 がちょうど1回だけ現れるようにしてください。
• キー欄に sk-... を貼り付けます。
• 接続し、Lite が取得したリストからモデルを選ぶか、ビルドが手動でのモデル名入力を求める場合は正確なカタログ id を入力します。
• 長いセッションを読み込む前に、新しいストーリーで短いメッセージを1件送って、正しく往復することを確認します。

Claude エンドポイントのオプションと、その使いどころ。

Lite のカスタムエンドポイントのグループには、Anthropic 方言の API 向けに Claude 形式のオプションも含まれています。APIsRouter はその方言も /v1/messages で提供しているため、claude の id にはどちらの入口からもたどり着けます。実際のところ、Claude モデルであっても OpenAI 互換の経路をデフォルトにする方がシンプルです。1つの設定であらゆるファミリーに対応できるからです。高品質な文章には claude-sonnet-4-6、ボリュームプレイには deepseek-v4-flash、ローテーションには glm-5.2 や kimi-k2.6 と、すべてモデル欄の変更だけで済み、設定のやり直しは不要です。 Claude 形式のオプションが活きるのは、Anthropic のリクエスト形式に合わせて調整済みのプリセットを維持している場合や、別の Anthropic 方言ツールから設定を移行する場合です。機能面では、このゲートウェイを通せばどちらの経路も同じモデルに行き着きます。どちらか一方を選んだら一貫させ、保存済みの設定が持ち運べる状態を保ちましょう。

サンプラーとモード: ホスト型エンドポイント上で実際に効くもの。

Lite は設定画面でローカルモデル向けのサンプラーを一通り揃えていますが、そのほとんどはホスト型エンドポイントには反映されません。OpenAI 互換のエンドポイント上では、Lite 自身のドキュメントが、Temperature・Top-P・Repetition Penalty 系のコントロールだけが有効だと述べています。Min-P、Top-A、TFS のようなエキゾチックなサンプラーはローカル推論向けの機能であり、Lite が追加フィールドとして付け足すことはできても、ホスト型エンドポイントの多くはこうした非標準パラメータを無視するか拒否します。Temperature は文章のばらつきを出すために 0.8〜0.9 前後、Top-P は 0.95 付近のまま、Repetition Penalty は低めに保ってください。それが調整可能な範囲のすべてで、それで十分です。 Lite の執筆モードはすべてカスタムエンドポイント上でも動作しますが、1点だけガイダンスがあります。Instruct モードはホスト型のチャットモデルに最も自然に対応します。そうしたモデルが訓練されている、構造化されたロールベースのやり取りを生み出すからです。従来型のストーリー共同執筆もうまく機能しますが、モデルは生のテキスト続行装置というより会話パートナーのように振る舞うと考えてください。それがチャット補完エンドポイントの本質だからです。 コンテキストの予算配分は、どのロールプレイフロントエンドとも同じルールに従います。Lite はターンごとに見えているストーリーの文脈を再送信するため、モデルのウィンドウが許すからといって最大まで広げるのではなく、コンテキストサイズは意図的に設定してください(16K〜32K 程度の作業ウィンドウが長いセッションをカバーします)。この計算は下記のコンテキスト長ガイドでモデルごとに扱っています。

従量課金 · 公式価格より安い

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

CORS、プロキシトグル、そしてキーの健全な管理。

Lite はブラウザから直接エンドポイントを呼び出すため、値は正しいのに接続に失敗する場合、たいてい CORS が原因です。エンドポイントがブラウザオリジンのリクエストを拒否しています。Lite にはまさにこのケース向けに「Use CORS Proxy」というトグルが用意されていますが、正直な注意が必要です。サードパーティのプロキシを経由させると、そのプロキシがあなたの通信の内側に入り込み、キーもストーリー内容も通過することになります。まずは直接接続を試し、不安なら curl でエンドポイントが動くことを確認し、プロキシトグルはデフォルトではなく最後の手段として扱ってください。ローカルの KoboldCpp から同梱の Lite を動かすのも、同じカスタムエンドポイント設定がそこにも存在するため、きれいな回避策の一つです。 ブラウザアプリならではの注意として、キーの衛生管理は少し余計に大事です。キーはブラウザのローカル設定に保存されるため、共有・公開された端末には貼り付けないようにし、万一漏れた場合は期待するのではなく取り消して再発行してください。キーの発行自体は無料なので、Lite 専用のキーを1つ用意しておけば利用ログが読みやすくなり、被害範囲も小さく抑えられます。 コンテンツについて一点はっきり述べておきます。カスタムエンドポイントはリクエストの行き先を変えるだけで、モデルが何を許可するかは変えません。上流のモデルポリシーと、利用している Lite インスタンスの規約はそのまま適用されます。下記のポリシー比較ページでモデルファミリーごとの状況を事実ベースにまとめています。

よくある質問