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 生成，请仔细甄别
