> ## Documentation Index > Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt > Use this file to discover all available pages before exploring further. # LobeHub > カスタムプロバイダーとローカルナレッジベースに対応した、オープンソースのAIチャットクライアント統合ガイド LobeHub は、複数のモデル、マルチモーダル入力、プラグインマーケットプレイス、ローカルナレッジベースをサポートするオープンソースのクロスプラットフォーム AI チャットクライアント（旧 Lobe Chat）です。APIYI を使えば、LobeHub で 1 つの API key から 400+ の主要な AI モデルにアクセスできます。プロバイダーごとに個別に登録して支払う必要はありません。 デスクトップ、web、Docker、または Vercel — あなたのデータ、あなたの管理 内蔵の web 検索、コードインタープリター、vision、動画生成プラグイン PDF と Markdown をアップロードして、プライベートデータ上に RAG パイプラインを構築できます ## クイックスタート ### 1. APIYI APIキーを取得する APIキーを取得するには、[API Key Management Guide](/ja/faq/token-management)を参照してください。 ### 2. LobeHub をインストールする LobeHub には3つの使い方があります。 * **デスクトップ**: Windows、macOS、Linux 向けの公式クライアント — `lobechat.com` からダウンロード * **Web（公式）**: `lobechat.com` にアクセスしてサインアップするだけで、セルフホスティングなしで利用できます * **セルフホスト**: Docker / Vercel / ローカルソース経由でデプロイ — エンタープライズ用途やプライバシー要件に最適です 個人利用には、公式Web版またはデスクトップクライアントをおすすめします。データプライバシーやコンプライアンス要件がある場合は、Docker でセルフホストしてください（APIYI は環境変数で設定するだけです）。 ### 3. カスタムプロバイダーを作成する LobeHub — カスタムAIサービスプロバイダーを作成 `Settings → Model Providers` に移動し、右上の `+` アイコンをクリックしてカスタムプロバイダーを追加し、上に示したとおりに各項目を入力します。 | 項目 | 値 | 備考 | | ------------- | -------------------------- | --------------------------------- | | **プロバイダーID** | `apiyi` | 一意の識別子 — 作成後は変更できません | | **プロバイダー名** | `apiyi` | カスタム表示名 | | **プロバイダーの説明** | `apiyi` | カスタム説明 | | **プロバイダーロゴ** | （空欄のまま） | 任意 — カスタムロゴURL | | **リクエスト形式** | `OpenAI` | APIYI は完全に OpenAI 互換です | | **プロキシURL** | `https://api.apiyi.com/v1` | ベースURL — **必ず `/v1` で終わる必要があります** | | **APIキー** | あなたの APIYI APIキー | APIYI のコンソールから取得してください | 右下の **作成** ボタンをクリックして保存します。 **設定のヒント** * `Proxy URL` は必ず `/v1` で終わる必要があります。そうでないとリクエストがルーティングされません * APIキーを貼り付けるときは、先頭や末尾のスペースを削除してください * 400以上の APIYI モデルすべてを利用するには、リクエスト形式として `OpenAI` を選択してください * 1つのキーで有効化済みのすべてのモデルに対応します — 使った分だけ支払います ### 4. 接続を確認する LobeHub — 設定済みプロバイダーの表示 プロバイダーを作成すると、その詳細ページが表示されます。ここから次の操作ができます。 1. **APIキーとプロキシURLを確認または更新する** 2. **高度なオプションを有効にする**（任意）: * `Use Responses API spec` — OpenAI の新しいリクエスト形式を有効にします（OpenAI モデルのみ） * `Use client-side request mode` — ブラウザが直接リクエストを送信し、応答速度が向上する場合があります 3. **接続確認** — ドロップダウンからモデルを選び、**チェック** をクリックします 4. **モデル一覧を取得** — **モデル一覧を取得** ボタンをクリックして、APIYI で利用可能なすべてのモデルを取得します 取得に成功すると、`Model list` に APIYI が現在提供しているすべての項目が、Chat、Image、Video、Embedding、ASR、TTS の種類別に表示されます。 接続確認が失敗した場合は、次のチェックリストを確認してください。 * プロキシURLは `/v1` で終わっていますか？ * APIキーはまだ有効ですか？（APIYI のコンソールで確認してください） * ネットワークから `api.apiyi.com` にアクセスできますか？ * ファイアウォールまたはプロキシが HTTPS 通信をブロックしていませんか？ ### 5. モデルを選んでチャットを始める チャット UI のモデル選択ドロップダウンで、`deepseek-v4-pro`、`claude-sonnet-4-5`、`gpt-5` などのモデルを選べば、すぐに使えます。 最新のモデルおすすめ、性能比較、シナリオ別の活用ヒントを確認できます。執筆、コーディング、高速応答、画像生成、動画生成などをカバーしています。 **ここに具体的なモデル一覧がないのはなぜですか？** AI モデルは非常に速く進化します。おすすめを正確に保つため、最新のモデル一覧、性能データ、活用ヒントは [Model Recommendation page](/ja/api-capabilities/model-info) で随時更新しています。 ## 1つのプロバイダーで400以上のモデルにアクセス LobeHub には、多くの主要プロバイダー向けの組み込みチャネルが用意されています。用途に合うチャネルを選んでください。 | チャネル | モデル | 主な利点 | APIエンドポイント | | ------------------- | -------------------------------------------- | ---------------------------- | -------------------------- | | **OpenAI互換（apiyi）** | 400以上のすべてのモデル（Claude、Gemini、GPT、DeepSeek など） | 1つのキーですべてを利用可能 — 最も簡単なセットアップ | `https://api.apiyi.com/v1` | **1つの apiyi チャネルで Claude、Gemini、その他すべてのモデルをカバー** APIYI は、Claude、Gemini、GPT、DeepSeek、その他の主要モデルを OpenAI互換プロトコルでまとめて提供します。そのため、LobeHub のカスタムプロバイダーに 1 つの `apiyi` を設定するだけで、ドロップダウンにある 400以上のすべてのモデルにアクセスできます。ベンダーごとに個別のチャネルを設定する必要はありません。 ## LobeHub の機能を徹底解説 ### プラグインマーケットプレイス LobeHub には充実したプラグインマーケットプレイス（`Settings → Plugins`）が付属しています。おすすめのプラグイン: * **Web Search** — モデルにリアルタイムのインターネットアクセスを提供 * **Code Interpreter** — チャット内で Python を実行してデータ分析と可視化を行う * **Chart Generation** — フローチャートやマインドマップを自動生成する * **Image Generation** — `gpt-image-1` や `flux-kontext-pro` のようなモデルを使って画像を生成する ### ローカルナレッジベース（RAG） LobeHub は、ファイルからローカルのベクターストアを構築できます。 1. `Knowledge Base` ページに移動して、新しいナレッジベースを作成します 2. PDF、Markdown、Word、Excel、TXT ファイルをアップロードします 3. システムが自動的にチャンク分割して埋め込みを作成します 4. チャットでナレッジベースを選択すると、モデルはファイルに基づいた回答を返します 埋め込みのステップでは、課金対象の埋め込みモデルが呼び出されます。APIYI の `text-embedding-3-large` や同様の埋め込みモデルの利用をおすすめします。 ### マルチモーダルチャット 画像をアップロードして、視覚理解、認識、OCR を利用できます: * 推奨される視覚モデル: `gpt-4o`, `claude-sonnet-4-5`, `gemini-3-pro-image-preview` * 画像をチャット入力欄にドラッグするだけで、モデルが認識します ### エージェントマーケットプレイス LobeHub には、あらかじめ用意された豊富なエージェント（翻訳、ライティング、コーディング、面接対策など）が付属しています。さらに、次のこともできます。 * `Agent marketplace` から、コミュニティ共有の任意のエージェントをワンクリックで有効化する * 独自のエージェントを構築する — カスタムペルソナ、prompt、オープニングライン、ナレッジベース、プラグインを設定可能 ### 会話管理 * 会話を分岐し、メッセージを編集し、応答を再生成する * 会話を Markdown、PNG、JSON としてエクスポートする * メッセージ履歴全体を横断してグローバル検索する ## 詳細設定 ### カスタムリクエストパラメータ プロバイダー詳細ページで、一般的なパラメータを調整できます。 ```yaml theme={null} Default parameters: Temperature: 0.7 # Creativity (reasoning models like gpt-5 / deepseek-r1 must use 1) Top P: 0.9 # Sampling (reasoning models must use 1) Max Tokens: 4096 # Maximum output length Context Length: 8192 # Context window ``` 推論モデル（GPT-5、DeepSeek-R1、o1シリーズなど）は、`Temperature = 1` と `Top P = 1` のみをサポートします。その他の値は無視されるか、サーバー側でエラーになります。 ### ネットワークプロキシとセルフホスティング プロキシ利用またはセルフホストの LobeHub の場合: 1. **デスクトップクライアント**: HTTP/HTTPS プロキシを設定するには `Settings → Network` 2. **セルフホスト（Docker）**: 環境変数経由で APIYI の設定を注入します: ```bash theme={null} OPENAI_API_KEY=sk-your-apiyi-key OPENAI_PROXY_URL=https://api.apiyi.com/v1 CUSTOM_MODELS=gpt-5,claude-sonnet-4-5,deepseek-v4-pro ``` 3. **クライアント側リクエストモード**: ブラウザからの直接リクエストを有効にします（ブラウザが APIYI に到達できる場合のみ） ### キーボードショートカット | ショートカット | 操作 | | ---------------------- | -------- | | `Ctrl/Cmd + N` | 新しい会話 | | `Ctrl/Cmd + K` | クイック検索 | | `Ctrl/Cmd + /` | コマンドパレット | | `Ctrl/Cmd + Shift + M` | モデルを切り替え | ## モバイル LobeHub のデスクトップクライアントは Windows / macOS / Linux で動作します。モバイルでは、`lobechat.com` のレスポンシブな Web アプリをご利用ください。別途インストールは不要です。 ## トラブルシューティング ### 接続失敗 / 接続チェックに失敗する | 症状 | 確認事項 | | ---------- | -------------------------------------------------------- | | 401 / 403 | API key が無効、または残高が不足しています — APIYI コンソールで確認してください | | 404 | Proxy URL に `/v1` のサフィックスがありません | | Timeout | ネットワークの問題です — プロキシまたはファイアウォールを確認してください | | CORS error | `Client-side request mode` をオフにするか、サーバーサイドのプロキシを経由してください | ### モデル一覧が空です * **モデル一覧を取得** をクリックして、再度取得します * 1〜2 秒待ってから、ページを更新してください * APIYI コンソールで API key が有効であることを確認してください ### 応答が遅い、または stream が中断される * より高速なモデルに切り替えます（例: `gpt-5-mini`、`claude-haiku-4-5`、`deepseek-v4-flash`） * 不要なプラグインを無効にします * ネットワークのレイテンシを確認します * 長いコンテキストを短くします（古い会話を閉じます） ### ナレッジベースの検索結果が不正確です * より細かい検索にするため、チャンクサイズを小さくします * APIYI でより強力な埋め込みモデルに切り替えます * 関連性の高いドキュメントを追加して、再現率を高めます ## ベストプラクティス ### モデル選択戦略 タスクに合ったモデルを使い、複雑さに応じて選択してください。 * **日常会話 / シンプルな Q\&A**: `gpt-5-mini`, `claude-haiku-4-5`, `deepseek-v4-flash` * **複雑な推論 / 長文ドキュメントの分析**: `gpt-5`, `claude-opus-4-5`, `deepseek-v4-pro` * **コーディング**: `claude-sonnet-4-5`, `gpt-5`, `deepseek-v4-pro` * **画像理解**: `gpt-4o`, `claude-sonnet-4-5`, `gemini-3-pro-image-preview` * **画像生成**: `gpt-image-1`, `flux-kontext-pro` モデル一覧全体と性能比較については、[モデル推奨ページ](/ja/api-capabilities/model-info)をご覧ください。 ### コンテキスト管理 * 古くなった会話は定期的に整理する * 複雑なタスクはより短い会話に分割する * 代替の返信を試すために `branch conversation` 機能を使う ### セキュリティとプライバシー * API key を公開しない * key は定期的にローテーションする（APIYIコンソールでワンクリックでリセットできます） * 機密性の高い会話では LobeHub をセルフホストする — データはローカルに保持されます ### セルフホストのヒント * 本番環境では、組み込み DB ではなく Docker + PostgreSQL を使う * Cloudflare をリバースプロキシとして前段に配置する * シークレットは環境変数で管理し、マルチインスタンス展開を簡単にする ## 他のクライアントとの比較 | 機能 | LobeHub | ChatBox | Cherry Studio | | --------------------- | --------------- | ------------------- | ------------- | | **オープンソースとセルフホスト可能** | ✅ | ❌ | ❌ | | **ローカル知識ベース（RAG）** | ✅ 標準搭載 | ❌ | ❌ | | **プラグインマーケットプレイス** | ✅ 豊富 | ❌ | 一部のみ | | **マルチモーダル** | ✅ | ✅ | ✅ | | **複数チャネルのネイティブプロトコル** | ✅ 多数標準搭載 | OpenAI 互換のみ | ✅ 3 形式 | | **モバイル** | レスポンシブ Web | ネイティブアプリ | ネイティブアプリ | | **クロスプラットフォーム** | デスクトップ + Web | デスクトップ + モバイル + Web | デスクトップ + モバイル | | **セルフホスト** | ✅ Docker/Vercel | ❌ | ❌ | **LobeHub を選ぶべきなのは？** * **ローカル知識ベース** や **プラグインエコシステム**（Web 検索、コードインタプリタ、チャートなど）が必要な場合 * データを完全に管理できる **プライベートデプロイ** をしたい場合 * デスクトップ + Web で共通の **統一されたオープンソース UI** を使いたい場合 **すぐ使える体験** と **ネイティブモバイルアプリ** を重視するなら ChatBox を選んでください。**Claude / Gemini のネイティブプロトコルと Prompt Cache による節約** を重視するなら、Cherry Studio が適しています。 さらにサポートが必要ですか？ `lobechat.com` ドキュメントを確認するか、[APIYI ウェブサイト](https://api.apiyi.com) をご覧ください。