沉浸式翻译接入中转站：自定义接口地址要写完整路径

沉浸式翻译是一个浏览器翻译插件，把网页翻译成原文和译文对照的样子，也能翻译 PDF、视频字幕等。它内置了很多家翻译服务，其中用大模型翻译的那些可以填自己的 key 和接口地址，接中转站用的就是这个。

需要填的是三样：key、模型名、自定义接口地址。

先记住一条和别的工具不一样的规则：这里的地址要写完整的接口路径，一直写到 /chat/completions：

https://你的中转站地址/v1/chat/completions

多数客户端只让你填到域名或 /v1，路径由它自己补。沉浸式翻译的 OpenAI 兼容接口要你自己写全，官方文档和中转站文档里的例子都是完整的路径。照别的工具的习惯只填到 /v1，就会不通。

如果你还没弄清中转站是什么、有哪些风险，先读中转站是什么和用中转站有什么风险；选站可以看中转站排行榜。

开始之前：从中转站拿到三样东西

需要什么	说明
接口地址	OpenAI 兼容接口的地址，记得补成完整路径
模型名	中转站模型页上写的名字，一字不差
API key	在中转站的控制台创建，多数站只显示一次

填法一：借用 OpenAI 这个翻译服务

这是官方文档“其他 AI 模型临时接入”一页写的办法，它用同样的方式接 Ollama、Groq 等兼容 OpenAI 接口的服务：

进入插件的设置页面，翻译服务选 OpenAI；
填 api_key：中转站的 key；
填 自定义模型：中转站的模型名；
填 自定义 URL 地址：完整的接口路径。

官方给的例子可以看出地址的写法：

服务	官方例子里的自定义 URL 地址
Ollama	`http://localhost:11434/v1/chat/completions`
Groq	`https://api.groq.com/openai/v1/chat/completions`

接中转站时照这个样子，把域名换成中转站的。以酷站AI 为例，它的文档写的 OpenAI 兼容接口就是 https://api.koozhan.com/v1/chat/completions，整段填进去。

填法二：添加自定义翻译服务

这一节的步骤出自中转站一方的接入文档，对应的是插件比较新的界面：

点浏览器工具栏上的沉浸式翻译图标，进入设置页面，点顶部的 翻译服务；
往下找到 其他/自定义 分组，点右上角的 添加自定义翻译服务；
填下面几项：

项目	填什么
自定义翻译服务名称	自己起一个名字
自定义 API 接口地址	`https://你的中转站地址/v1/chat/completions`
APIKEY	中转站的 key
模型	勾选“输入自定义模型名称”，填中转站的模型名

点 点此测试服务，通过后保存；
回到翻译服务列表，把这个服务旁边的开关打开，设成当前默认的服务。

之后打开任意网页，按 Alt + A（Mac 是 Option + A）就可以翻译。

两种填法做的是同一件事。你的版本里有“添加自定义翻译服务”就用填法二，它不占用 OpenAI 那一栏，名字也更好认。

用 Claude 原生接口

官方文档的翻译服务列表里有 Claude 这一项，它的接口是 Anthropic 的 /v1/messages。按中转站一方的接入文档，可以直接用内置的 Claude 服务，填 key、自定义接口地址和模型名，不用另外添加自定义服务。

这一栏的地址要写到哪一级，照你用的中转站的文档。没有说明、测试又不通过时，换成 OpenAI 兼容接口的填法更省事：翻译用不到 Claude 原生接口才有的功能。后半句是我们的看法，不是官方的说明。

翻译和聊天不一样：请求又多又密

翻译一个网页，插件会把页面拆成很多段，同时发出很多个请求。这和聊天时一问一答很不一样，接中转站时要多留意两处。

出现 429：调低每秒最大请求数

官方文档在 OpenAI 一页写得很明白：出现 429 错误，说明超出了服务的频率限制，建议调低每秒的最大请求数。它给的参考：

从 0.5.0 版起，默认是每秒最多 10 个请求；
翻译电子书时尤其要调低，调到每秒 5 个请求会稳定一些。

中转站一般也有频率限制，而且各家不同。翻译时译文缺一段少一段、反复出现 429，先把这个数调低。

填多把 key

官方文档说明，插件支持多个 API key 负载均衡，填的时候用英文逗号隔开。在同一家中转站多建几把 key，可以分摊每把 key 的频率限制。前提是它的限制是按 key 算的，按账号算的话没有用。后半句是我们的补充。

费用和隐私

费用由中转站收。 官方文档的免责声明写着：各翻译服务的费用完全由该服务商收取，与插件无关，提醒大家留意额度，避免意外扣费。

翻译的用量容易被低估。一篇长文章就有上万个字符，开着“自动翻译”浏览一天，用掉的 token 可能比聊天多得多。两条建议，是我们的看法：

选便宜、速度快的模型。 翻译网页不需要最强的模型，价格差几倍到几十倍。
先用几天，再看账单。 到中转站的控制台看这把 key 的消耗，心里有数了再决定要不要一直开着自动翻译。

你翻译的页面内容会发给中转站。 这一点和聊天不同：聊天时发什么由你决定，翻译时发出去的是整个页面的文字。公司内部系统、邮箱、网银这类页面，翻译之前想一想能不能交给第三方。官方文档里有“隐私模式”和“敏感信息脱敏”两页说明，用之前值得看一眼；中转站这一侧的风险见用中转站有什么风险。

常见问题

现象	检查什么
测试服务不通过	地址是不是写了完整的路径，到 `/chat/completions` 为止；key 和模型名是否正确
报 `String contains non ISO-8859-1 code point`	中转站一方的说法：key 里混进了全角空格、中文等非英文字符，重新复制一遍
翻译到一半出现 `429`	调低每秒最大请求数
页面上有的段落没翻译	多半也是频率限制，同上；再看中转站的余额
配好了但没有用它翻译	翻译服务列表里，这个服务旁边的开关有没有打开
提示模型不存在	模型名是否和中转站的完全一致；有的中转站要求带厂商前缀
花费比预想的高	换便宜的模型；关掉自动翻译，只在需要时手动翻译

接上之后

验证拿到的是不是真模型。 翻译得出来不等于给你的是它声称的模型，便宜模型也能翻译。用同一把 key 到 Veridrop 检测，背景见中转站怎么掺假。
给翻译单独建一把 key。 不要和写代码、聊天用同一把。这样用量分得清，出了问题停掉这一把也不影响别处。
对话客户端的接法：Cherry Studio 接入中转站、Chatbox 接入中转站。