Fluent Read（流畅阅读）接入

难度 🖱️ 简单　|　接口格式 NewAPI（内置引擎）　|　base_url https://byesu.com

接入信息 · 填这几样

接口地址https://byesu.com

API 密钥sk-xxxxxxxx去控制台创建 →

推荐模型gpt-5.5

接口格式 NewAPI · 模型名以 控制台 实际为准

Fluent Read（流畅阅读）是一款开源的浏览器翻译插件，支持 20 多种翻译引擎与 AI 模型，提供母语级的双语对照阅读体验。接入半页酥 API 后，你就能用 GPT、Claude、Gemini 等大模型来翻译网页。

开始之前

先到 控制台 → 令牌 创建一个 API 令牌（形如 sk-xxxx）。创建时务必选对分组——分组决定了你能调用哪些模型，选错会导致「无可用渠道」。详见 选择分组。

第 1 步：安装插件

Fluent Read 支持主流浏览器，挑你用的那个安装：

• Chrome：Chrome 应用商店搜索「Fluent Read」，国内用户可用 crxsoso.com 镜像
• Edge：Edge 加载项商店搜索「流畅阅读」
• Firefox：Firefox 附加组件商店搜索「Fluent Read」

安装后浏览器工具栏会出现 Fluent Read 图标。

第 2 步：配置半页酥 API

点击工具栏的 Fluent Read 图标，进入设置页。Fluent Read 内置了 NewAPI 翻译引擎（半页酥就是 NewAPI 架构），直接选它，按下表填写：

字段	填写内容
翻译服务	选择 NewAPI
NewAPI 接口	https://byesu.com（不带 /v1，插件会自动补全路径）
访问令牌	你的 byesu 令牌，形如 sk-xxxx
模型	在列表中选择，或选「自定义模型」填入下方模型名
自定义模型	例如 gpt-5.5

推荐模型

翻译这类任务对速度和性价比敏感，按需选择：

• gpt-5.5 —— 通用翻译，速度与质量均衡
• claude-opus-4-8 —— 长文、专业文档翻译质量更佳
• gemini-3.1-pro-high —— 多语种、长上下文表现出色

模型名必须与控制台「可用模型」里的名称完全一致，且要在你令牌所选分组的范围内。

接口地址别填错

选 NewAPI 引擎时，「NewAPI 接口」填不带 /v1 的 https://byesu.com——插件会自己拼路径，多写 /v1 会变成 /v1/v1 而接不通。只有当你改用「OpenAI / 自定义 OpenAI 兼容」引擎时，接口地址才需要带 /v1（https://byesu.com/v1）。两种都试不通时，对照下方「卡住了？」排查。

第 3 步：跑起来验证

1. 保存设置。
2. 打开任意一篇外文网页（例如一篇英文文章）。
3. 点击 Fluent Read 图标，选择「翻译当前页面」或使用其划词翻译。
4. 页面出现中文双语对照译文，即接入成功。

如果迟迟没有译文，先打开浏览器右键菜单 → 检查 → Console，看是否有报错，再对照下方排查。

卡住了？

• 401 / 令牌无效：检查令牌是否复制完整（含 sk- 前缀）、有没有多余空格。见 常见错误 #auth。
• 无可用渠道 / no channel：多半是令牌分组选错，该分组下没有你填的模型。换成正确分组，或改用分组内的模型名。见 选择分组 与 常见错误 #no-channel。
• 额度不足 / 余额不够：账户或令牌额度用尽，前往控制台充值或调整令牌额度。见 常见错误 #balance。
• 请求超时 / 没有译文：NewAPI 引擎下确认接口地址是 https://byesu.com（不带 /v1）；OpenAI 兼容引擎下才是 https://byesu.com/v1。别写成其他占位地址。

更多排查见 常见错误。