用戶端/WorkBuddy

在 WorkBuddy 中使用 Wokey API

取得 Wokey API 金鑰，將 WorkBuddy 的 Base URL 指向 Wokey，再用一個 curl 請求確認連線。

更新於

本頁內容expand_more

準備 API 金鑰與 Base URLlink

所有用戶端都使用同一組 Wokey API 金鑰和同一個 Base URL。

建立 API 金鑰

登入後在 API 頁面建立平台金鑰；同一帳號下的金鑰共用餘額。

建立 API 金鑰key

使用 Wokey Base URL

用戶端的 Base URL 填入閘道網域；是否加上 /v1 請參考下方設定。

設定用戶端link

WorkBuddy 的自訂模型使用 OpenAI Chat Completions。在 WorkBuddy 中開啟 Settings → Model → Custom models，填入 Wokey 的端點、API 金鑰與 deepseek-v4.1-flash，之後 WorkBuddy 的任務與 Agent 工作流程就能使用工具呼叫與圖片輸入。

  1. 1

    開啟模型設定

    點選 WorkBuddy 左下角的帳號按鈕 → Settings → Model。也可以開啟模型選擇器並選擇 Configure custom model。

  2. 2

    新增自訂模型

    選擇 Custom。將端點設為 https://api.wokey.ai，貼上你的 Wokey API 金鑰，並輸入精確的模型 ID deepseek-v4.1-flash（舊的 deepseek-flash ID 也可以使用）。

  3. 3

    設定能力

    啟用工具呼叫與圖片輸入。推理模式與自訂協定保持關閉。deepseek-v4.1-flash 支援文字、圖片與工具；若改用 deepseek-v4-flash，請關閉圖片輸入，因為該模型只支援文字。

  4. 4

    儲存並切換模型

    執行 Test connection、儲存模型，然後在對話的模型選擇器中選取它。測試工具或圖片之前，先用一段簡短的文字提示詞確認。

WorkBuddy
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

API 格式與 Base URLlink

同一個用戶端切換 API 格式時，Base URL 結尾是否帶 /v1 可能不同。

格式Base URL適用於
OpenAI Chat Completionshttps://api.wokey.aiDeepSeek、GLM、Kimi 等其他模型

設定位置: Settings → Models → Custom models

常見疑難排解link

  • 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：降低並行數、縮短上下文，或稍後重試；也可以切換到其他可用的模型。

用 curl 驗證link

用戶端回報錯誤時，先用 curl 排除金鑰與 Base URL 的問題。

WorkBuddy 預設使用 OpenAI Chat Completions 格式。這個請求回傳 200，代表金鑰和 Base URL 都正確；送出前請把 YOUR_API_KEY 換成你的金鑰。

cURL
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" }
    ]
  }'

錯誤與疑難排解link

先區分認證、餘額、限流、模型無法使用與上游逾時等情況。

401

invalid api key

金鑰缺少、輸入錯誤、已刪除，或 Authorization 與 x-api-key 標頭內容衝突。

402

insufficient balance

帳號餘額不足。請先儲值再繼續送出請求。

403

model_denylisted / account_restricted

因重複違規，對該模型或帳號下所有模型的呼叫已被暫停。請參閱「違規處理費與限制」。

403

request_blocked

這個請求在送達上游前就被攔截，不會計費，例如原封不動地重送模型剛拒答的請求，或來自已暫停的終端使用者（X-End-User-Id）。錯誤訊息會說明被攔截的原因；請依訊息修改請求或稍後重試。其他請求不受影響。

429

rate limited

請求過於頻繁。請稍後重試或降低並行數。若只有某一個模型或某一個終端使用者（X-End-User-Id）持續回傳 429，可能是違規後的暫時限制。

499

client disconnected

用戶端在回應完成前關閉了連線（代碼 downstream_aborted）。預設不收費。當帳號在過去 24 小時內至少有 50 次用戶端中斷，且占其請求的 10% 以上時，之後中斷的請求會依上游回報的用量計費：已處理的輸入（含快取讀取與寫入），以及僅在上游有計入時的輸出。在上游回報任何用量之前就中斷的請求仍然免費。開始計費時會通知帳號，中斷率恢復正常後一小時內會自動停止計費。常見原因是用戶端或代理的逾時設定太短，或程式在請求完成前就取消了請求。

502

upstream unavailable

上游模型服務暫時無法使用。請切換模型或稍後重試。

504

upstream timeout

上游回應逾時。請縮短上下文、調低 max_tokens 或重試。

529

upstream overloaded

上游模型暫時過載，Wokey 已經在其他路由上重試過（代碼 upstream_overloaded）。這與你的餘額無關。請稍後重試或切換模型。

常見問題link

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 是文字模型，使用它時請關閉圖片輸入。