WorkBuddy（騰訊） 串接教學
騰訊的 AI 辦公智慧體，新增一個自訂模型就能用櫻桃茶的模型做事
- 介面：OpenAI Chat Completions
- 網址寫法：寫完整到 /v1/chat/completions（https://gpt.cherrychat.org/v1/chat/completions）
- 推薦模型：claude-sonnet-5-5、gpt-6.1-sol
- 平台：macOS、Windows
串接步驟
開啟模型設定
開啟 WorkBuddy，進入「設定」→「模型」（通常從右上角的帳號選單進入設定），找到「自訂模型」區塊。
新增模型，選「自訂」
點「新增模型」，在提供商清單裡選「自訂 / Custom」（不要選清單裡的其他服務商）。
填介面網址、API Key 與模型名稱
介面網址寫全到 /v1/chat/completions，WorkBuddy 只支援這種 OpenAI 相容格式；Claude 模型也照樣填這個網址。
- 介面網址（URL）：https://gpt.cherrychat.org/v1/chat/completions（寫完整路徑，不要只填網域或 /v1）
- API Key：sk-你的金鑰
- 模型名稱（模型 ID）：claude-sonnet-5-5
進階設定
「自訂協定」開關保持關閉。上下文長度可選 128K；能力標記不會自動辨識，Claude、GPT 系列都支援工具呼叫，可以勾選「工具呼叫」，不確定的模型寧可少勾。
儲存並測試
儲存後回到對話介面，在模型選擇器的「自訂模型」群組中選取它，傳一句「你好」，有回覆就接通了。
容易踩的坑
- 介面網址寫全 https://gpt.cherrychat.org/v1/chat/completions：「自訂協定」關閉時 WorkBuddy 會依標準 /chat/completions 校驗並補全網址，寫完整路徑最穩。
- 只支援 OpenAI 相容（Chat）格式，不能填 Claude 原生介面；櫻桃茶的 Claude 模型也支援 Chat 格式，照常填 https://gpt.cherrychat.org/v1/chat/completions。
- 能力標記要手動勾選：沒勾「工具呼叫」時智慧體功能受限，勾了但模型不支援會報錯。
- 設定（含 key）只儲存在本機，不會上傳；用自訂模型的費用從櫻桃茶點數扣除，不占 WorkBuddy 自己的點數。
- 設定入口和按鈕位置可能隨 WorkBuddy 版本變動，以軟體裡的實際介面為準。
錯誤訊息 → 原因 → 怎麼辦
| 看到的錯誤 | 原因 | 怎麼辦 |
|---|---|---|
| 儲存或對話時出現 401 | API Key 複製錯了、帶了空格，或這把 key 已停用 | 到 API 頁「我的金鑰」重新複製後貼上 |
| 出現 404 或「請求失敗」 | 介面網址只寫了網域或 /v1，或開啟了「自訂協定」卻沒寫完整路徑 | 介面網址改成 https://gpt.cherrychat.org/v1/chat/completions，「自訂協定」保持關閉 |
| 提示模型不存在 | 模型名稱寫錯（大小寫、多空格） | 依模型價格頁逐字填寫，例如 claude-sonnet-5-5 |
| 出現 402 或「餘額不足」（Claude 格式顯示 billing_error） | 帳戶點數不足以支付這次呼叫。API 呼叫只扣點數，會員卡與無限卡都不抵扣 | 到櫻桃茶·智域GPT 的「商店」儲值任意金額，幾秒後重試即可 |
| 出現 429 Too Many Requests | 請求太快：預設每把 key 每分鐘最多 120 次，每個帳號同時最多 8 個請求 | 調低工具裡的並行數或每秒請求數，依提示的 Retry-After 秒數稍等再試；多數工具會自動重試 |
教學核對於 2026-11-02。工具介面改版後可能和這裡略有不同，以官方文件為準。
Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 內容由 AI 生成，請仔細甄別
