プロバイダーとモデル

TomoriBotには組み込みのAIモデルはありません。プロバイダーから接続する必要があります。プロバイダーとはAIサービス（Google Gemini、OpenRouter、NovelAI、ローカルエンドポイントなど）のことであり、モデルはそのプロバイダー上の特定のモデルを指します。トモリを利用するには、少なくとも1つのプロバイダーが必要です。

APIキー

初回のセットアップ時に/setupでプロバイダーのキーを追加するか、後から/providersで 新しいプロバイダーの追加（Add New Provider）を選択して追加します。キーは保存時に暗号化されるため、サーバー管理者を含め、誰も読み取ることはできません。

/setupでは、何よりもまず返信がどのようにモデルに届くべきかを尋ねられ、その回答によって収集される内容が決まります。

モード	収集される内容
AIプロバイダー（推奨）	カタログからのプロバイダーとそのAPIキー。検証され、ドラフトとして暗号化されます。
カスタムエンドポイント（詳細）	エンドポイントの接続と1つのテキストモデル。ウィザード内で登録されます。カスタムエンドポイントを参照してください。
ユーザーBYOK（ギルドのみ）	なし：ワークスペース自体はプロバイダーを保持しないため、メンバーが個人のものを提供する必要があります。

セットアップを完了（Finish Setup）するまで何も書き込まれないため、中断または期限切れになったウィザードは、ワークスペースの既存のプロバイダー設定を変更しません。すでに保存されているキーを置き換える場合は、/providersを使用してください。すでに設定されているワークスペースでは/setupの実行が拒否されるためです。

各プロバイダーには独自のキー生成手順があります。**/help**を実行し、セットアップ（Setup）、ステップ1：APIキーを取得（Step 1: Get an API Key）の順に選択し、プロバイダーを選んで正確な手順を確認するか、以下の開始点を参照してください。

プロバイダー	メモ	キーの取得
Google Gemini	無料枠あり、全機能が動作。最初のセットアップにおすすめ。	AI Studio
OpenRouter	1つのキーで多数のモデルを利用（一部無料）。	OpenRouter keys
NovelAI	サブスクリプション。無修正のストーリーテリング・ロールプレイ（テキストのみ）。	NovelAI
DeepSeek	従量課金制の推論モデル。	DeepSeek
NVIDIA NIM	ホスト型のテキスト、埋め込み、画像。	NVIDIA Build
Anthropic	API経由のClaudeモデル（Claude Codeではありません）。	なし
Z.ai	GLMファミリー。⚠️ 利用規約によりコーディング・エージェントのシナリオに限定。	Z.ai
Vertex AI	`gcloud` ADC経由のGoogle Cloud。ローカル実行や開発用セットアップに最適。	下記参照
Vertex AI Express	Google Cloud APIキーのBYOK（プレビュー版、Geminiのサブセット）。	Express Mode
カスタム	任意のOpenAI互換エンドポイント（Ollama、vLLM、LiteLLMなど）。	カスタムエンドポイントを参照

Vertex AIは、保存されたシークレットではなくアプリケーションのデフォルト認証情報（Application Default Credentials）で認証を行います。ローカルホスティングの場合、ADCはgcloudから取得できます。ホストされたデプロイメントでは、ワークロードIDまたはサービスアカウントを使用する必要があります。AI StudioのAPIキーだけでは、完全なVertex AIの認証はできません。選択したプロジェクトは請求設定が有効であり、Vertex AI APIが有効化されている必要があります。また、ホストIDにはVertexへのアクセス権が必要です。セットアップガイドは、/helpの APIキー（API Keys）ページから Google Vertex AI を選ぶと確認できます。

Googleバックエンドのプロバイダーのセットアップでは、認証済みのモデル一覧エンドポイントを通じて認証情報を検証します。テキストを生成したり、現在カタログのデフォルトとしてマークされているチャットモデルに依存したりすることはありません。そのため、デフォルトのモデルが廃止されても、有効な認証情報の保存が妨げられることはありません。

オプション：Brave Searchキー

Brave SearchはAIプロバイダーとは別であり、ウェブ検索を強化するだけのものです（画像、動画、ニュースの検索を追加します）。/providersで設定します。⚠️ Braveには月額5ドルの無料クレジットが含まれています。料金の発生を防ぐため、Braveのダッシュボードで5ドルの利用制限を設定してください。

モデルの選択

/providersはサーバーの認証情報、モデルカタログ、エンドポイントの登録を管理し、/config > モデル > モデルの切り替えは、このサーバーの全員が使用する共通の機能割り当てを選択します。どちらも必要なサーバー権限が要ります。個々のメンバーは/personal providersで自身の認証情報とモデルカタログを管理し、/personal configで個人用モデルを選択します。個人設定は、TomoriBotを使用するすべてのサーバーに引き継がれます。個人設定側の詳細は、パーソナライゼーションを参照してください。

パネルには サーバーのプロバイダー（Server Providers）および 個人のプロバイダー（Personal Providers）というタイトルが付けられており、コマンドのインタラクションが開いた後も所有権がわかるようになっています。

プロバイダーを設定した後、/config > モデル > モデルの切り替えを使用して、共通の機能割り当てを選択します。6つの通常のスロットで、プロバイダーのカタログからモデルのエントリーを選択します。

/config > モデル > モデルの切り替え：メインのチャットモデル
/config > モデル > モデルの切り替え：ビジョンモデル（チャットモデルが画像を読み取れない場合に画像を読み取るため）
/config > モデル > モデルの切り替え：ドキュメントナレッジベース用の埋め込み（embeddings）
/config > モデル > モデルの切り替え：標準の画像生成（画像生成を参照）
/config > モデル > モデルの切り替え：NovelAIの画像生成
/config > モデル > モデルの切り替え：動画生成
/config > モデル > モデルの切り替え：テキストから音声（TTS）へのエンドポイント
/config > モデル > モデルの切り替え：音声からテキスト（STT）へのエンドポイント

最初の6つのエントリーは、モデルカタログのレコードを選択します。TTSとSTTのスロットは、モデルの列に書き込むのではなく、ワークスペーススコープのエンドポイントを選択してアクティブにします。これらのエンドポイントは/providersで登録および編集します（エンドポイントのアクティブ化制御も引き続き機能します）。/personal configは6つの個人用モデルルーティングスロットを保持し、個人用のTTS/STTエンドポイントの選択ツールは追加されません。

また、/providersを使用して、このサーバーの自動フェイルオーバーと負荷分散用のバックアップキーを管理することもできます。

カスタムエンドポイント

カスタムエンドポイントを使用すると、セルフホストまたはプロキシベースのサービス（Ollama、LM Studio、LiteLLM、vLLM、ComfyUI、ローカルのTTS/STTなど）をラベル付きのプロバイダーバンドルとして登録できます。

サーバー全体： ワークスペースのエンドポイントの登録と編集には/providersを開きます。
個人用： 個人のモデルカタログには/personal providersを開きます（あなた専用です。パーソナライゼーションを参照）。個人用の音声エンドポイントは/personal configから選択されません。

ラベルはユーザー向けメニューに表示される名前で、同じエンドポイントURLを使用する機能を1つのバンドルにグループ化します。リモートエンドポイントには送信されません。異なるURLから提供される機能には、別々のラベルが必要です。新しいカスタムエンドポイントを追加を選び、API互換性を選択して接続を保存します。保存すると、モデルを登録せずに、そのプロトコルがサポートする機能の準備が行われます。次に、新しいエンドポイントを選択し、そのモデルのドロップダウンを使用して、正確なモデルコードと機能を登録します。モデルを追加すると、その機能で直ちに有効になります。同じドロップダウンを使用して、さらにモデルを追加したり、ワークスペースに追加された登録を編集したりできます。テキストモデルはそのフォームで独自の機能を宣言し、画像モデルはサポートするリクエストモードを宣言します。

TTSとSTTについては、/providersでエンドポイントとそのモデルを登録し、/config > モデル > モデルの切り替えでエンドポイントを選択してアクティブにします。これらの音声スロットは、モデルカタログのエントリーではなくエンドポイントを選択します。/providersは引き続き、エンドポイントの登録、モデルの設定、および編集の画面として機能します。

API互換性は、サービスが実装するリクエストパスとペイロードを決定するため、接続が準備する機能スロットも決定します。これらのスロットに正確なモデルを登録することは別の手順であり、エンドポイントURLからプロトコルを確実に推測することはできません。

/setupの カスタムエンドポイント（詳細） モードは、ウィザード内で同じ2つの手順を実行します。接続の設定（Configure Connection）では、到達可能性チェックの背後でAPI互換性、ラベル、URL、オプションの認証トークンを保存し、テキストモデルの設定（Configure Text Model）では、正確なテキストモデルとその機能の宣言を登録します。モデルボタンは接続が検証されるまで無効のままであり、宣言はAPI互換性に依存するため、接続を再保存するとモデル宣言がクリアされます。セットアップを完了（Finish Setup）を押すと、ウィザードは接続、保存されたプロバイダー、モデル、およびアクティブモデルの行をまとめて作成するため、使用可能なテキストモデルがない接続が残ることはありません。登録されるのはテキストモデルのみです。画像、動画、TTS、STTの機能は引き続き/providersで登録します。

サーバーの実行に関する完全な手順については、以下をご覧ください。

セットアップ：ローカルLLM：Ollama、KoboldCPP、LM Studio、vLLM、LiteLLM。
セットアップ：ComfyUI：ローカルの画像・動画生成。
セットアップ：ChatMock：ChatGPTアカウント / Codex CLI。

サポートされているプロバイダー

モデルをホストするためのハードウェアがない場合でも、TomoriBotは幅広いサービスをサポートしています。すべての機能がすべてのプロバイダーで利用できるわけではありません。

LLMプロバイダー

プロバイダー	ストリーミング	ツール呼び出し	画像入力	埋め込み	メモ
Google Gemini	✅	✅	✅	✅	無料モデルあり
OpenRouter	✅	✅	✅	✅	無料モデルあり
Anthropic (API)	✅	✅	✅	なし	Claude Codeではありません
NovelAI	✅	✅	なし	なし	GLM 4.6のみツールを使用可能
NVIDIA NIM	✅	✅	✅	✅	無料モデルあり
DeepSeek	✅	✅	なし	なし	なし
Z.ai	✅	✅	✅	なし	無料モデルあり。⚠️ 利用規約 = コーディング・エージェント使用のみ
Z.ai Coding	✅	✅	なし	なし	サブスクリプションプラン
Google Vertex AI	✅	✅	✅	✅	「無料」のExpress版を含む
Codex CLI (ChatMock経由)	✅	✅	✅	なし	セットアップ

画像生成

プロバイダー	テキストからの画像生成	画像からの画像生成	インペインティング	メモ
Google	✅	✅	なし	なし
OpenRouter	✅	✅	なし	なし
NovelAI	✅	✅	✅	他のプロバイダーと組み合わせ可能
NVIDIA	✅	なし	なし	テキストから画像のみ。参照画像は無視されます
Z.ai	✅	なし	なし	なし

これらはプロバイダーの画像モデルが初期状態で使用するデフォルトであり、NovelAIはこの表ではなく独自のパイプラインを通じて実行されます。/providersから画像モデルを登録すると、そのモデル独自のモードを宣言できます。これにより、ComfyUIワークフローや、マスク編集をサポートするAPIを持つプロバイダーモデルでインペインティングを有効にできます。一度も宣言されていないモデルは上記のデフォルトに従い続けるため、後でデフォルトが修正された場合は自動的に反映されます。モデルが実際に実行できることだけを宣言してください。トモリはチェックされたモードをそのままツールに提供するため、APIが拒否するモードは生成の失敗につながります。

動画生成

プロバイダー	テキストからの動画生成	画像からの動画生成	メモ
Google	✅	✅	非同期のポーリングワークフロー
OpenRouter	✅	✅	非同期のポーリングワークフロー
Z.ai	✅	✅	非同期のポーリングワークフロー

音声とオーディオ

プロバイダー	テキストからの音声生成	音声からテキストへの変換
ElevenLabs	✅	✅

ローカルの音声エンジンについては、セルフホストで説明されています。組み込みのウェブ検索およびURL取得エンジンについては、ツールと拡張機能をご覧ください。