流畅阅读接入 Models Hub:配置自定义翻译引擎
在流畅阅读(FluentRead)浏览器插件里把翻译引擎切到 Models Hub,填入密钥与接口地址后网页翻译走 Models Hub 额度,附推荐模型与常见报错排查。
流畅阅读(FluentRead)是一款开源浏览器翻译插件,支持双语对照、划词翻译和全文翻译。它内置了 AI 大模型翻译引擎,把引擎指向 Models Hub 后,插件里的所有翻译请求都会用 Models Hub 的额度调用你指定的模型。本文只讲接入这一步,插件本身的功能用法见官方项目主页。
三样东西
接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com(不带 /v1)、一个模型名。
准备
- 已安装流畅阅读插件。Chrome 用户去 Chrome 应用商店(或国内镜像),Edge 去 Edge 应用商店,Firefox 去 附加组件商店。项目地址:GitHub。
- 一个 Models Hub API Key。在控制台的 令牌页 创建,令牌所在分组要能访问你打算用的模型。
推荐模型
网页翻译请求量大、频率高,模型选择直接影响成本,优先选便宜快速的模型;偶尔翻译专业文档想要更准确,再切成更强的模型。
| 用途 | 模型名 | 定价 | 实时状态 |
|---|---|---|---|
| 日常网页翻译首选,速度快 | gpt-5.4-mini | 查看价格 | 可用率与延迟 |
| 便宜快速,备选项 | claude-haiku-4-5 | 查看价格 | 可用率与延迟 |
| 专业文档、长文追求准确 | claude-sonnet-4-6 | 查看价格 | 可用率与延迟 |
模型名以 模型定价页 为准。
配置步骤
方式一:令牌页一键填充(如可用)
部分 Models Hub 站点在 令牌页 的令牌旁提供跳转流畅阅读的快捷选项,选择模型后一键填充到插件,会弹出确认窗口核对信息。这个入口是否出现取决于站点后台开关,以你当前令牌页的实际界面为准;没有就用下面的手动配置。
方式二:手动填写配置
打开流畅阅读的设置页(点浏览器工具栏图标进入),按下表填写:
| 配置项 | 填什么 |
|---|---|
| 翻译服务 | 选 Models Hub(部分版本显示为「自定义」或「OpenAI 兼容」) |
| 访问令牌 | 你的 Models Hub API Key |
| 接口地址 | https://modelsok.com,不带 /v1,插件会自己拼接 |
| 模型 | 从列表选,或选「自定义模型」手动填入上面推荐的模型名 |
验证
保存后打开任意一个外文网页,用划词翻译选中一段文字,或点悬浮球做全文翻译,能看到中文译文即接通。再打开 Models Hub 控制台的 用量日志,几秒内会出现一条对应模型名的请求,确认走的是 Models Hub。
常见报错
| 现象 | 原因 | 处理 |
|---|---|---|
| 翻译一直转圈或报错无结果 | 接口地址填错,常见是多写了 /v1 | 改回 https://modelsok.com,不带 /v1 |
提示令牌无效 / 401 | Key 复制不完整,或令牌被禁用 | 到 令牌页 重新复制 |
| 提示模型不存在 | 自定义模型名拼错,或令牌所在分组没有该模型 | 对照 定价页 核对拼写 |
全文翻译时大量请求失败 / 429 | 悬浮球一次性发起并发过高,触发限流 | 稍后重试,或改用划词翻译分段处理 |
| 用量日志里没有记录 | 翻译服务没有切成 Models Hub,或改完没保存 | 重新打开设置页确认翻译服务与三项配置都已保存 |
更多排查见 故障排查。
常见问题
计费方式? 按每次翻译请求实际消耗的输入与输出 token 计费,价格看各模型定价页。全文翻译会拆成多个小请求,用量日志能看到明细。
和直接用 OpenAI 官方接口有什么区别? 填的字段完全一样,只是把接口地址换成了 Models Hub,不需要自己申请 OpenAI 账号。
怎么换模型? 回到设置页,把「模型」或「自定义模型」改成表格里的其它模型名,保存即生效。