# WorkBuddyでカスタムモデルを設定する方法 > WorkBuddy でカスタム モデルを 3 つの手順で構成します。[モデルの追加] を開き、[カスタム] を選択し、OmniaKey API URL、キー、および正確なモデル ID を入力し、保存して確認します。 - Canonical HTML: https://omniakey.com/ja/blog/workbuddy-custom-model-setup - Markdown: https://omniakey.com/ja/blog/workbuddy-custom-model-setup.md - Published: 2026-08-20 (updated 2026-09-21) - Author: Kiki, COO at OmniaKey - Language: ja - Category: API setup - Reading time: 8 min - All posts: https://omniakey.com/blog/llms.txt --- このガイドでは、WorkBuddy の現在のカスタム モデル インターフェイスを使用します。 WorkBuddy を開く前に、OmniaKey API キーと 1 つの正確なモデル ID を準備します。 > **完成したフォーム:** **カスタム**を選び、Base URL には `https://api.omniakey.com/v1`, OmniaKey API キー、正確なモデル ID（例: `deepseek-v4-flash`）を入力します。 フォーム、保存されたモデルの詳細、モデル ピッカーは、WorkBuddy `v5.3.14` を実行する macOS アプリでチェックされました。 Tencent Cloud の公式手順では、この機能を使用するには少なくとも `v4.22.15` が必要です。 |WorkBuddy フィールド|値| |-|-| |プロバイダー|**Other** グループの下の `Custom`| |インターフェースアドレス|`https://api.omniakey.com/v1`| |API キー|OmniaKey で作成されたキー| |機種名|たとえば、`deepseek-v4-flash`| ## 始める前に2つのアイテムを準備してください ### OmniaKey API キー OmniaKey にサインインし、[API キー ページ](https://omniakey.com/ja/dashboard/tokens) を開きます。 1. **キーの作成**を選択します。 2. `WorkBuddy` という名前を付け、適切な制限と有効期限を設定します。 3. それを作成し、すぐに新しいキーをコピーします。 認証情報を WorkBuddy に貼り付けるまで、キー ダイアログを開いたままにしてください。 スクリーンショット、チャット メッセージ、または公開ファイルにキーを含めないでください。 アカウントには利用可能な残高またはトライアル クレジットも必要です。 キーを作成すると、資格情報のみが作成されます。 アカウントがリクエストに資金を提供できることを保証するものではありません。同じキーはほかのツールでも使えます。詳しくは[Cherry Studio の API 設定](https://omniakey.com/ja/blog/cherry-studio-api-setup)、[Cline のカスタム API キー](https://omniakey.com/ja/blog/cline-custom-api-key)、[Claude Code の設定](https://omniakey.com/ja/blog/claude-code-setup)のガイドをご覧ください。 ### 正確なモデル ID [OmniaKey モデル カタログ](https://omniakey.com/ja/models) を開き、現在利用可能なモデルを選択し、ページに表示されているモデル ID をコピーします。 最初のテストでは、次を使用します。 ```text deepseek-v4-flash ``` ID は正確に一致する必要があります。 表示名 `DeepSeek V4 Flash` を入力したり、ハイフンを削除したり、より短いエイリアスを作成したりしないでください。 ## ステップ 1: モデルの追加を開く WorkBuddy を起動して、以下を開きます。 ```text System Settings → Models → + Add model ``` \[モデル] ページで、右上隅にある \[**+ モデルの追加**] を選択します。 ![WorkBuddy 右上隅に「モデルの追加」ボタンがあるモデル設定ページ](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/01-open-model-settings.2eba6570.1000.webp) _ステップ 1: システム設定 → モデル → + モデルの追加。_ 新しいタスクの最後から入力することもできます。 ```text Model picker → + Configure custom model ``` どちらのエントリも使用できない場合は、WorkBuddy をバージョン `v4.22.15` 以降に更新します。 Tencent Cloud の現在の手順では、インターフェイスに少なくともこのバージョンが必要です。 ## ステップ 2: \[カスタム] を選択し、4 つのフィールドに入力します。 フォームを上から下に記入してください。 ### 1. カスタムプロバイダーの選択 \[プロバイダー] メニューを開き、次を選択します。 ```text Custom ``` `v5.3.14` では、**Other** グループの下に表示されます。 組み込みの OpenAI、Tencent Cloud Token Plan、または別のプロバイダーは選択しないでください。これらのプロファイルは OmniaKey インターフェイス アドレスを使用しないためです。 ![WorkBuddy プロバイダー メニューの下部にあるカスタム プロバイダー オプション](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/02-choose-custom-provider.fabcb941.560.webp) _ステップ 2: \[プロバイダー] メニューの一番下までスクロールし、\[その他] の下の \[カスタム] を選択します。_ ### 2. `/v1` を通じてアドレスを入力してください **インターフェイス アドレス** または **Base URL** に、次のように正確に入力します。 ```text https://api.omniakey.com/v1 ``` > **灰色のプレースホルダーはコピーしないでください。** `/v1/chat/completions` で終わる例が示されていますが、このフィールドで使う OmniaKey の Base URL は `https://api.omniakey.com/v1` です。 ### 3. API キーを貼り付けます OmniaKey からコピーしたキーを **API キー** に貼り付けます。 引用符、空白、または `Bearer` という単語を追加しないでください。 キー値のみを入力します。 ### 4. モデル名を入力してください **モデル名** または **Model ID** の下に、正確なカタログ ID を入力します。 ```text deepseek-v4-flash ``` コア フォームは次のようになります。 ```text Provider: Custom Interface address: https://api.omniakey.com/v1 API Key: [your OmniaKey API key] Model name: deepseek-v4-flash ``` ![OmniaKey インターフェイス アドレスと deepseek-v4-flash モデル名が入力された WorkBuddy カスタム モデル フォーム](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/03-fill-omniakey-fields.addb54d9.560.webp) _完成した例。 スクリーンショットでは、API キーは意図的に空白になっています。 WorkBuddy を構成するときに、独自の OmniaKey キーを貼り付けます。_ 最初の接続テストでは、残りのフィールドをデフォルトのままにし、**カスタム プロトコル** がオフになっていることを確認します。 `v5.3.14` では、新しいフォームは Tool calling オン、画像入力オフ、推論モード オフ、カスタム プロトコル オフ、およびプロバイダーのデフォルトの入出力制限で始まります。 検証済みの `deepseek-v4-flash` プリセットが以下に表示されます。 ## ステップ 3: モデルを保存し、選択してテストします。 **保存** を選択し、新しいタスクに戻ります。 下部にあるモデル ピッカーを開き、カスタム モデル セクションを見つけて、`deepseek-v4-flash` を選択します。 短いテスト メッセージを 1 つ送信します。 ```text Reply with exactly: Connection successful ``` 通常の応答では、セットアップの 4 つの部分が一度に確認されます。 1. WorkBuddy はカスタム プロバイダーを保存しました。 2. Base URL が正しいです。 3. API キーは受け入れられ、使用可能なクレジットがあります。 4. キーは選択したモデル ID にアクセスできます。 最後に、[OmniaKey の使用法](https://omniakey.com/ja/dashboard/usage) を開き、呼び出しが予期したモデルで表示されることを確認します。 これにより、WorkBuddy から OmniaKey までの検証ループが閉じます。 保存したモデルがすぐに表示されない場合は、ピッカーを閉じて再度開きます。 それでも表示されない場合は、完全に終了して、WorkBuddy を再起動します。 ## 最初のテストに推奨される詳細設定 基本的なチャットが機能する前に、いくつかの機能コントロールを変更しないでください。 WorkBuddy `v5.3.14` の新しいカスタム モデルは次で始まります。 |オプション|新しいフォームのデフォルト| |-|-| |Tool calling|オン| |画像入力|オフ| |推理モード|オフ| |カスタムプロトコル|オフ| |入力および出力の制限|プロバイダーのデフォルト| これらのデフォルトを使用して、最初に URL、キー、およびモデル名を確認します。 次に、モデルの機能を調整します。 ### `deepseek-v4-flash`プリセットを確認 保存されたモデルと成功したローカル応答では、次の構成が使用されました。 |オプション|`deepseek-v4-flash`設定| |-|-| |Tool calling|オフ| |画像入力|オフ| |推理モード|**オン**| |推理のみ|オフ| |推論の無効化を許可する|**オン**| |カスタムプロトコル|**オフ**| |デフォルトの推論作業|`Auto (use request-layer default)`| |サポートされた推論の取り組み|「低」、「中」、「高」、「超高」、および「最大」のチェックを外したままにします。| |入力および出力の制限|プロバイダーのデフォルト| WorkBuddy は、推論のみ、推論の無効化を許可、および推論モードが有効になった後のエフォート制御を明らかにします。 最初のテストでは努力を自動のままにしておきます。 ### ツール呼び出しを有効にする場合 WorkBuddy がファイルの読み取り、コネクタの使用、またはエージェント タスクの実行を必要とする場合は、**Tool calling** を有効にします。 モデルは構造化されたツール呼び出しもサポートする必要があります。 現在、`deepseek-v4-flash` は OmniaKey カタログにツール サポートがあるため、基本的なチャットが機能した後に有効にして、読み取り専用タスクから開始します。 接続のみのチャット テストではオフのままにすることができます。 ### 画像入力を有効にする場合 画像を受け入れるように明示的にマークされたモデルに対してのみ有効にします。 クライアント スイッチは、テキストのみのモデルにビジョン機能を追加できません。 ### 推論モードを有効にする場合 カタログまたはモデルのドキュメントに推論、思考、または同様のモードが明示的にリストされている場合に有効にします。 自動努力を維持し、推論を無効にすることを許可します。 サポートされていない努力値を追加したり、推論専用モードを通常のタスクのデフォルトにしないでください。 ## 別のモデルを追加する 作業モデルのエントリを上書きしないでください。 \[**モデルの追加**] を再度開き、同じ OmniaKey URL と API キーを保持し、正確なモデル ID のみを置き換えて、別のカスタム モデルとして保存します。 次のモデルを追加する前に、1 つのモデルを確認してください。 問題が発生した場合、これにより、どの保存済みエントリによって問題が引き起こされたのかが明確になります。 ## 症状別のトラブルシューティング ### カスタムモデルの構成がありません まず WorkBuddy のバージョンを確認してください。 `v4.22.15` 以降に更新してから、新しいタスク モデル ピッカーまたは **システム設定 → モデル** を確認します。 ### HTTP 401, 未承認または無効な API キー OmniaKey キーを再度コピーします。 空白をチェックし、`Bearer` を空白と一緒に貼り付けていないことを確認してください。 キーが有効で有効期限が切れていないこと、およびアカウント残高とキー制限の両方が使用可能であることを確認します。 モデル ID を変更しても、`401` は修正されません。 モデルの選択が問題になる前に認証に失敗しました。 ### HTTP 404 またはエンドポイントが見つかりません アドレスは正確に次のようにする必要があります。 ```text https://api.omniakey.com/v1 ``` ベア ドメインを使用したり、`/v1` を複製したり、`/chat/completions` を追加したりしないでください。 また、**カスタム プロトコル** がオフになっていることを確認してください。 ### モデルが見つからないか、`UNKNOWN_MODEL` [ライブ モデル カタログ](https://omniakey.com/ja/models) から ID を再度コピーします。 表示名、推測されたエイリアス、または廃止された ID は、有効な現在のモデル ID ではありません。 ### チャットは機能するがツールが失敗する 基本モデルの接続はすでに機能しています。 WorkBuddy の Tool calling スイッチとモデルのツール機能を確認してください。 API キーまたは URL を再入力しても、ツール サポートは追加されません。 ### 画像入力に失敗する 両方の条件が真である必要があります。モデルが画像をサポートしており、WorkBuddy の画像入力コントロールが有効になっています。 ### 保存後にモデルが見つからない **保存** を選択したことを確認し、モデル ピッカーを再度開きます。 必要に応じて、WorkBuddy を再起動します。 構成エントリ自体が使用できない場合は、クライアントのバージョンを再度確認してください。 ## よくある質問 ### WorkBuddy はどの OmniaKey URL を使用する必要がありますか? 使用するのは `https://api.omniakey.com/v1`. これは Base URL であり、操作パスは WorkBuddy が追加します。 ### `models.json` ファイルが必要ですか? いいえ。WorkBuddyでカスタムモデルを設定する方法では、現在の **カスタム モデルの構成** インターフェイスに従います。 古いローカル構成ファイルの手順では、別のセットアップ パスが説明されています。 ### GPT、Claude、Gemini、または別のモデルを構成できますか? はい、モデルが現在 OmniaKey に掲載されており、OpenAI 互換ルートをサポートしている場合に限ります。 同じ URL を保持し、正確なカタログ モデル ID を使用します。 ### MCP はこのフォームに設定されていますか? いいえ。このフォームはモデル API を構成します。 MCP とコネクタは別の WorkBuddy 設定です。 これらのツールを追加する前に、基本的なモデル応答を確立してください。 ## 検証済みの参考文献 - [Tencent Cloud: WorkBuddy の構成と使用](https://cloud.tencent.com/document/product/1823/130064) - [OmniaKey OpenAI 互換の API リファレンス](https://docs.omniakey.com/en/api/openai-compatible) - [OmniaKey ライブ モデル カタログ](https://omniakey.com/ja/models)