WorkBuddy で Wokey API を使う

1. 1

   モデル設定を開く

   WorkBuddy の左下にあるアカウントボタン → Settings → Model をクリックします。モデルセレクターを開いて Configure custom model を選ぶこともできます。

2. 2

   カスタムモデルを追加する

   Custom を選びます。エンドポイントを https://api.wokey.ai に設定し、Wokey の API キーを貼り付け、正確なモデル ID deepseek-v4.1-flash を入力します（旧 ID の deepseek-flash も使えます）。

3. 3

   機能を設定する

   ツール呼び出しと画像入力を有効にします。推論モードとカスタムプロトコルはオフのままにしてください。deepseek-v4.1-flash はテキスト、画像、ツールに対応しています。代わりに deepseek-v4-flash を使う場合は、そのモデルはテキスト専用なので画像入力をオフにしてください。

4. 4

   保存してモデルを切り替える

   Test connection を実行してモデルを保存し、会話のモデル選択から選びます。ツールや画像を試す前に、まず短いテキストのプロンプトで確認してください。

Provider: Custom
Endpoint: https://api.wokey.ai
API key: YOUR_API_KEY
Model: deepseek-v4.1-flash
Tool calling: On
Image input: On
Reasoning mode: Off
Custom protocol: Off

設定場所: Settings → Models → Custom models

• 404：エンドポイントは https://api.wokey.ai のままにし、カスタムプロトコルはオフにしてください。カスタムプロトコルがオンの場合に限り、https://api.wokey.ai/v1/chat/completions の完全なパスを入力します。
• 401：API キーの欄にはキーそのものを貼り付け、Bearer プレフィックスは付けないでください。キーが有効で、アカウントに残高があることを確認してください。
• model_not_found：モデル ID を deepseek-v4.1-flash に設定し、スペースや余分な接尾辞を付けないでください。
• 画像リクエストが失敗する：deepseek-v4.1-flash を選び、画像入力を有効にしてください。deepseek-v4-flash はテキストのみに対応しています。
• 429、502、504、529：同時実行数を減らすか、コンテキストを短くするか、時間をおいて再試行してください。ほかの利用可能なモデルに切り替えることもできます。

WorkBuddy はデフォルトで OpenAI Chat Completions 形式を使います。このリクエストで 200 が返れば、API キーと Base URL は正しく設定されています。送信前に YOUR_API_KEY をご自身のキーに置き換えてください。

curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

WorkBuddy の API アドレスに /v1 は必要ですか？

不要です。https://api.wokey.ai を指定し、カスタムプロトコルのスイッチはオフのままにしてください。カスタムプロトコルをオンにした場合に限り、完全なアドレス https://api.wokey.ai/v1/chat/completions を入力します。両者が一致しないと 404 が返ります。

モデル名には何を入力しますか？

正確なモデル ID（例：deepseek-v4.1-flash）を、スペースや接尾辞なしで入力します。それ以外は model_not_found が返ります。

画像リクエストが失敗するのはなぜですか？

モデルが deepseek-v4.1-flash で、画像入力のスイッチがオンになっているか確認してください。deepseek-v4-flash はテキストモデルなので、使用するときは画像入力をオフにしてください。