WorkBuddyでカスタムモデルを設定する方法
URL、API キー、モデル名をこの順に入力し、接続が完了していることを確認します。
このガイドでは、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 キー ページ を開きます。
- キーの作成を選択します。
WorkBuddyという名前を付け、適切な制限と有効期限を設定します。- それを作成し、すぐに新しいキーをコピーします。
認証情報を WorkBuddy に貼り付けるまで、キー ダイアログを開いたままにしてください。 スクリーンショット、チャット メッセージ、または公開ファイルにキーを含めないでください。
アカウントには利用可能な残高またはトライアル クレジットも必要です。 キーを作成すると、資格情報のみが作成されます。 アカウントがリクエストに資金を提供できることを保証するものではありません。
正確なモデル ID
OmniaKey モデル カタログ を開き、現在利用可能なモデルを選択し、ページに表示されているモデル ID をコピーします。 最初のテストでは、次を使用します。
deepseek-v4-flash
ID は正確に一致する必要があります。 表示名 DeepSeek V4 Flash を入力したり、ハイフンを削除したり、より短いエイリアスを作成したりしないでください。
ステップ 1: モデルの追加を開く
WorkBuddy を起動して、以下を開きます。
System Settings → Models → + Add model
[モデル] ページで、右上隅にある [+ モデルの追加] を選択します。
新しいタスクの最後から入力することもできます。
Model picker → + Configure custom model
どちらのエントリも使用できない場合は、WorkBuddy をバージョン v4.22.15 以降に更新します。 Tencent Cloud の現在の手順では、インターフェイスに少なくともこのバージョンが必要です。
ステップ 2: [カスタム] を選択し、4 つのフィールドに入力します。
フォームを上から下に記入してください。
1. カスタムプロバイダーの選択
[プロバイダー] メニューを開き、次を選択します。
Custom
v5.3.14 では、Other グループの下に表示されます。 組み込みの OpenAI、Tencent Cloud Token Plan、または別のプロバイダーは選択しないでください。これらのプロファイルは OmniaKey インターフェイス アドレスを使用しないためです。
2. /v1 を通じてアドレスを入力してください
インターフェイス アドレス または Base URL に、次のように正確に入力します。
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 を入力します。
deepseek-v4-flash
コア フォームは次のようになります。
Provider: Custom
Interface address: https://api.omniakey.com/v1
API Key: [your OmniaKey API key]
Model name: deepseek-v4-flash
最初の接続テストでは、残りのフィールドをデフォルトのままにし、カスタム プロトコル がオフになっていることを確認します。 v5.3.14 では、新しいフォームは Tool calling オン、画像入力オフ、推論モード オフ、カスタム プロトコル オフ、およびプロバイダーのデフォルトの入出力制限で始まります。 検証済みの deepseek-v4-flash プリセットが以下に表示されます。
ステップ 3: モデルを保存し、選択してテストします。
保存 を選択し、新しいタスクに戻ります。 下部にあるモデル ピッカーを開き、カスタム モデル セクションを見つけて、deepseek-v4-flash を選択します。
短いテスト メッセージを 1 つ送信します。
Reply with exactly: Connection successful
通常の応答では、セットアップの 4 つの部分が一度に確認されます。
- WorkBuddy はカスタム プロバイダーを保存しました。
- Base URL が正しいです。
- API キーは受け入れられ、使用可能なクレジットがあります。
- キーは選択したモデル ID にアクセスできます。
最後に、OmniaKey の使用法 を開き、呼び出しが予期したモデルで表示されることを確認します。 これにより、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 またはエンドポイントが見つかりません
アドレスは正確に次のようにする必要があります。
https://api.omniakey.com/v1
ベア ドメインを使用したり、/v1 を複製したり、/chat/completions を追加したりしないでください。 また、カスタム プロトコル がオフになっていることを確認してください。
モデルが見つからないか、UNKNOWN_MODEL
ライブ モデル カタログ から ID を再度コピーします。 表示名、推測されたエイリアス、または廃止された ID は、有効な現在のモデル ID ではありません。
チャットは機能するがツールが失敗する
基本モデルの接続はすでに機能しています。 WorkBuddy の Tool calling スイッチとモデルのツール機能を確認してください。 API キーまたは URL を再入力しても、ツール サポートは追加されません。
画像入力に失敗する
両方の条件が真である必要があります。モデルが画像をサポートしており、WorkBuddy の画像入力コントロールが有効になっています。
保存後にモデルが見つからない
保存 を選択したことを確認し、モデル ピッカーを再度開きます。 必要に応じて、WorkBuddy を再起動します。 構成エントリ自体が使用できない場合は、クライアントのバージョンを再度確認してください。
よくある質問
WorkBuddy はどの OmniaKey URL を使用する必要がありますか?
使用するのは https://api.omniakey.com/v1. これは Base URL であり、操作パスは WorkBuddy が追加します。
models.json ファイルが必要ですか?
いいえ。このガイドは、現在の カスタム モデルの構成 インターフェイスに従います。 古いローカル構成ファイルの手順では、別のセットアップ パスが説明されています。
GPT、Claude、Gemini、または別のモデルを構成できますか?
はい、モデルが現在 OmniaKey に掲載されており、OpenAI 互換ルートをサポートしている場合に限ります。 同じ URL を保持し、正確なカタログ モデル ID を使用します。
MCP はこのフォームに設定されていますか?
いいえ。このフォームはモデル API を構成します。 MCP とコネクタは別の WorkBuddy 設定です。 これらのツールを追加する前に、基本的なモデル応答を確立してください。