沉浸式翻译接入 Models Hub:自定义 AI 翻译服务配置
在沉浸式翻译浏览器插件里把翻译服务切到 OpenAI 自定义接口,填入 Models Hub 的地址与密钥,网页翻译改用 Models Hub 额度,附验证与常见报错排查。
沉浸式翻译是一款浏览器插件,能在原网页上直接叠加译文,支持切换成任意 OpenAI 兼容的 AI 翻译服务。把它的翻译服务指向 Models Hub 后,平时刷网页、看论文、看外文视频字幕的翻译请求都会用 Models Hub 的额度,不需要单独去申请 OpenAI 账号。本文只讲接入这一步。
三样东西
接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com/v1/chat/completions(要写完整路径,不是普通的 Base URL)、一个模型名。
准备
推荐模型
网页翻译量大、请求频繁,优先选便宜快速的模型;偶尔翻译长文档、专业资料想要更准确,再切成更强的模型。
| 用途 | 模型名 | 定价 | 实时状态 |
|---|---|---|---|
| 日常网页翻译首选,速度快 | gpt-5.4-mini | 查看价格 | 可用率与延迟 |
| 便宜快速,备选项 | claude-haiku-4-5 | 查看价格 | 可用率与延迟 |
| 长文档、专业内容追求准确 | claude-sonnet-4-6 | 查看价格 | 可用率与延迟 |
模型名以 模型定价页 为准。
配置步骤
-
点浏览器工具栏上的沉浸式翻译图标,打开 设置(齿轮图标,会跳转到独立的设置页面)。
-
在左侧找到 翻译服务,列表里选 OpenAI。⚠️ 以当前版本界面为准,不同版本这个入口的名字可能是「翻译服务」或「AI 翻译服务」。
-
展开 更多设置,会出现几个新字段,按下面填:
字段 填什么 API Key 你的 Models Hub API Key,多个 Key 可以用英文逗号隔开做负载均衡 自定义 API 地址 https://modelsok.com/v1/chat/completions(官方示例地址都是这种完整路径,不是只填到/v1)自定义模型 上面表格里的模型名,如 gpt-5.4-mini⚠️ 以上三个字段的中文原文标签以你当前版本实际看到的为准,官方文档里的英文命名是
api_key、Custom URL、Custom model。 -
如果翻译速度不稳定或频繁报错,把 每秒最大请求数 调低一点,官方建议从默认的 10 调到 5。
验证
保存设置后,打开任意一个外文网页,点插件图标里的「翻译」或直接双语显示,能看到中文译文出现即接通。再打开 Models Hub 控制台的 用量日志,几秒内会出现一条对应模型名的请求,确认走的是 Models Hub。
常见报错
| 现象 | 原因 | 处理 |
|---|---|---|
| 网页一直显示「翻译失败」或转圈不出结果 | 自定义 API 地址填错,常见是漏了 /chat/completions 只填到 /v1 | 回到 更多设置,把地址改成完整的 https://modelsok.com/v1/chat/completions |
提示 401 或密钥无效 | API Key 复制不完整、多了空格或换行,或令牌已被禁用 | 到 令牌页 重新复制,注意别带多余空格 |
提示 429 或短时间内大量失败 | 每秒最大请求数设得太高,触发限流 | 回到 更多设置 把每秒最大请求数从默认值调到 5 |
| 提示模型不存在 | 自定义模型名拼错,或令牌所在分组没有该模型 | 对照 定价页 核对拼写 |
| 译文没变化,还是走的官方默认服务 | 翻译服务没有切换成功,或改完没保存 | 重新打开设置页确认翻译服务确实选中了 OpenAI,且三个字段都保存了 |
更多排查见 故障排查。
常见问题
计费方式? 按每次翻译请求实际消耗的输入与输出 token 计费,价格看各模型定价页。网页翻译一次会拆成多个小请求,用量日志里能看到明细,不用担心一次翻译就产生很大费用。
和直接用 OpenAI 官方接口有什么区别? 填的地址、字段完全一样,只是把域名换成了 Models Hub,不需要自己申请 OpenAI 账号和信用卡。
怎么换模型? 回到设置页的「更多设置」,把「自定义模型」改成表格里的其它模型名,保存后立刻生效,不用重启浏览器。