本页参考 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
Edge
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。
发布前检查
以下检查适用于客户端中选择 OpenAI 兼容 或 Responses 提供商的场景；如果你选择的是 Anthropic、Gemini 等原生协议，请按对应协议的接口和返回结构配置。
- 模型 ID：先用目标 API Key 请求
GET https://top.qingyuntop.ai/v1/models，把返回的data[].id原样填入客户端。截图、教程和历史配置中的模型名不保证仍可用。 - 协议选择：新 OpenAI 集成优先选择 Responses；只有客户端或模型明确要求 Chat Completions 时才选择 Chat。Responses 的返回从
output读取，Chat 的返回从choices[].message读取。 - Base URL：通常填写
https://top.qingyuntop.ai/v1，也就是只保留一个/v1。要求完整接口地址的客户端才追加/responses或/chat/completions，不要重复追加。 - 流式与重试：流式响应必须按所选协议解析事件；连接中断后不要盲目重放可能已被服务端接受的生成请求。对 429 和 5xx 使用带抖动的退避，并设置连接、读取和总超时。
- 上线前验证：分别验证普通文本、流式文本、工具调用或结构化输出中实际用到的能力，并记录
request id、HTTP 状态、业务状态和完成原因，避免只根据 HTTP 200 判定成功。