Bob（macOS 翻譯） 串接教學
macOS 上的劃詞 / 截圖翻譯工具，裝 OpenAI Translator 外掛就能用櫻桃茶模型翻譯
- 介面：OpenAI Chat Completions
- 網址寫法：寫完整到 /v1/chat/completions（https://gpt.cherrychat.org/v1/chat/completions）
- 推薦模型：deepseek-v4-flash、gpt-5.4-mini
- 平台：macOS
串接步驟
安裝 OpenAI Translator 外掛
先確認 Bob 是 1.8.0 或更新版本。到外掛的 GitHub Releases 頁下載最新的 openai-translator.bobplugin，連按兩下，Bob 會提示安裝成功。
新增翻譯服務
開啟 Bob「偏好設定」→「服務」，選「文字翻譯」，點清單下方的「+」，選「OpenAI Translator」。
填 API Key、模型與 API URL
「模型」選「自訂模型」後填模型名稱；API URL 要寫完整網址。
- API Key：sk-你的金鑰
- 自訂模型：deepseek-v4-flash
- API URL：https://gpt.cherrychat.org/v1/chat/completions（必須以 /chat/completions 結尾）
儲存並測試
「推理」保持「預設」，「串流輸出」保持開啟，點「儲存」。選取一段英文並按 Bob 的劃詞翻譯快速鍵，出現譯文就成功了。
容易踩的坑
- API URL 必須寫全並以 /chat/completions 結尾（https://gpt.cherrychat.org/v1/chat/completions）；以 /responses 結尾會改走 Responses 介面，只寫網域會提示格式不正確。
- API URL 不能留空：留空時外掛會送到 OpenAI 官方，櫻桃茶的 key 會被拒絕。
- 「推理」選「關閉」時，部分模型會出現參數錯誤，保持「預設」最穩。
- 劃詞翻譯用量不大但很頻繁，選便宜快速的模型（如 deepseek-v4-flash）就夠了；多把 key 用英文逗號分隔。
錯誤訊息 → 原因 → 怎麼辦
| 看到的錯誤 | 原因 | 怎麼辦 |
|---|---|---|
| 提示「API URL 格式不正確」 | 網址沒有以 /chat/completions 結尾 | 改成 https://gpt.cherrychat.org/v1/chat/completions |
| 翻譯失敗，出現 401 | API Key 複製錯了、帶了空格，或 API URL 留空送到了別處 | 重新複製 key，並確認 API URL 填的是 https://gpt.cherrychat.org/v1/chat/completions |
| 提示模型不存在 | 沒選「自訂模型」，或模型名稱寫錯 | 選「自訂模型」，填 deepseek-v4-flash |
| 出現 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 生成，請仔細甄別
