配置速查
三个字段，外加一个模型选择上的重要建议。
| 配置项 | 填什么 | 容易错在哪 |
|---|---|---|
API 地址 | https://turingapi.space/v1 | 必须带 /v1 |
API Key | 控制台创建的 sk- 密钥 | 建议单独建一把，方便统计翻译用量 |
模型 | 轻量模型，如 claude-haiku-4-5 | 用旗舰模型翻整页又慢又贵 |
为什么强调轻量模型：翻译属于典型的短文本任务，不需要推理能力。用旗舰模型翻一整页长文，速度和成本都会差一个数量级，而质量提升几乎没有感知。
前置准备
先想清楚用量，再配模型。
1
单独创建一把密钥
在控制台新建一把专用于翻译的密钥，这样用量页能单独看出翻译花了多少。
2
挑一个轻量模型
claude-haiku-4-5 或类似定位的模型最适合翻译场景。
3
估算一下余额
网页翻译的调用量比手动聊天大得多，余额太少会撞上 403。
配置步骤
在插件的开发者设置里配置，配完记得选为默认翻译服务。
添加自定义翻译服务 主流程
- 打开插件设置，进入「开发者设置」
- 找到「添加自定义翻译服务」
- 选择 OpenAI 兼容的类型
- API 地址填
https://turingapi.space/v1 - 填入 API Key 和模型名
- 保存后设为默认翻译服务
服务添加后不会自动启用，要在翻译服务列表里手动选一次。
控制调用量 省钱关键
- 「译文风格」选简洁，减少输出 token
- 不需要时关掉「上下文感知」之类的增强选项
- 翻译长文前先看余额是否够
上下文感知会把前后文一起发过去，质量更好但 token 消耗明显增加。
触发限流怎么办 高频场景
- 插件有并发上限设置，调低一点更稳
- 整页翻译时容易瞬间打出几十个请求
- 如果持续 429，说明该分组的并发限制到了
翻译是典型的瞬时高并发场景，比聊天更容易撞限流。
验证是否配置成功
看到这些就说明通了
- 随便打开一个英文网页，选中一段右键翻译
- 译文正常出现，不是报错或空白
- 控制台「用量」页出现若干条短请求
用量页里会出现密集的小请求，这是翻译这个场景的正常形态。
翻译不出来的排查顺序
- 确认服务已设为默认
- 确认地址带
/v1 - 确认模型名有效、余额充足
插件报错信息通常很简短，按这个顺序排查比看提示快。
常见问题
翻译场景的问题和聊天很不一样，重点在成本和并发。
为什么建议用轻量模型？
翻译是短文本、大批量、不需要推理的任务。旗舰模型在这个场景既慢又贵，质量差异用户几乎感知不到。用 haiku 这类轻量模型是性价比最优的选择。
余额还有，但一直提示失败？
先看是不是撞了并发限制。整页翻译会瞬间发出很多请求，部分分组有并发上限。把插件的并发数调低通常能解决。
能把地址填成不带 /v1 的吗？
不行。沉浸式翻译把地址原样当 base 用，不会自己补路径，必须填 https://turingapi.space/v1。
翻译质量不好怎么调？
先换一个更强的模型试试，如果提升明显说明是模型能力问题；如果没有变化，问题多半在提示词或「译文风格」设置上。
相关客户端
CCherry Studio
图形界面配置，点「获取模型列表」自动拉取
通通用 OpenAI 兼容
两种地址写法，互换一次就能解决大半问题
OOpenAI Python SDK
改一个参数，业务代码不用动
CChatBox
API 模式要选 OpenAI Compatible
还没密钥？注册后直接创建一个
邮箱注册即用，控制台自助创建密钥、查看用量与余额。
免费注册 →
接入过程卡住了？到 QQ 群 1128182538 说明「客户端 + 报错码 + 时间点」，比只说"用不了"好排查得多。其他通用问题见 常见问题。