本页参考 New API 官方 AI 应用文档，已按青云 TOP API（New API 兼容）环境整理。API 地址使用 https://top.qingyuntop.ai/v1，API Key 使用 $QINGYUN_TOP_API_KEY 占位符，请在青云 TOP API 控制台创建并妥善保存密钥。

FluentRead 教程 — 开源浏览器翻译插件，支持 20+ 翻译引擎与 AI 大模型翻译。对接 青云 TOP API 实现沉浸式双语阅读体验。

聊天设置选项

在 青云 TOP API 控制台的系统设置->聊天设置中，可添加如下快捷选项，便于在令牌管理页一键填充到 FluentRead：

{ "流畅阅读": "fluentread" }

🌊 流畅阅读（FluentRead）是一款开源浏览器翻译插件，致力于提供母语般的阅读体验。

🌟 核心特性

智能翻译引擎

  • 多引擎支持：支持 20+ 种翻译引擎
  • 传统翻译：微软翻译、谷歌翻译、DeepL翻译等
  • AI 大模型：OpenAI、DeepSeek、Kimi、Ollama等
  • 自定义引擎：支持自定义翻译服务配置

沉浸式阅读体验

  • 双语对照：原文与译文并列显示，阅读更轻松
  • 划词翻译：选中任意文本，即时获得翻译结果
  • 一键复制：快速复制译文，提高阅读效率
  • 全文翻译：悬浮球一键翻译整个网页，无需刷新页面

隐私与定制

  • 隐私保护：所有数据本地存储，代码开源透明
  • 高度定制：丰富的自定义选项，满足不同场景需求
  • 完全免费：开源免费，非商业化项目

📦 安装方式

浏览器

安装方式

Chrome

Chrome 应用商店 | 国内镜像

Edge

Edge 应用商店

Firefox

Firefox 附加组件商店

🚀 配置方法

从 青云 TOP API 控制台导入配置（推荐）

当浏览器安装了流畅阅读插件后，打开 青云 TOP API 控制台->令牌管理页面会弹出添加流畅阅读的提示

选择模型后点击一键填充到FluentRead，会弹出确认窗口，检查对应的信息是否正确

确认导入后在流畅阅读中的青云 TOP API配置便会启用

在流畅阅读中手动填写配置

配置项

内容

翻译服务

青云 TOP API

访问令牌

青云 TOP API 密钥

青云 TOP API接口

青云 TOP API部署地址（不带/v1）

模型

列表中选择，或者自定义模型

自定义模型

模型名称

接入检查

  • API 地址填写青云 TOP API 的 Base URL：https://top.qingyuntop.ai/v1；应用若要求不带 /v1 的站点地址，请按页面说明填写对应格式。
  • API Key 只使用环境变量 $QINGYUN_TOP_API_KEY 或应用的安全密钥存储，不要把真实密钥提交到代码仓库。
  • 模型名称必须与控制台可用模型完全一致；遇到 401/403 检查密钥、分组和模型权限，遇到 404 检查 Base URL 是否重复填写 /v1。