沉浸式翻译 接入万模API

适用协议:OpenAI Chat | 适合:网页翻译、双语阅读和长网页摘要

沉浸式翻译会把网页分段发送给模型,因此一次翻译长网页可能产生很多请求。新手配置时先用短网页验证,确认模型和费用都符合预期后再开启整页翻译。

开始前确认

项目应该准备什么
浏览器插件已安装沉浸式翻译
API Key控制台创建的 sk-...
Base URLhttps://www.wanmoapi.com/v1
协议OpenAI Chat
模型名轻量、稳定、成本合适的 Chat 模型

配置步骤

  1. 打开浏览器扩展管理,确认沉浸式翻译已启用。
  2. 打开沉浸式翻译设置。
  3. 进入翻译服务或 AI 翻译服务设置。
  4. 选择自定义 OpenAI、OpenAI Compatible 或类似服务。
  5. Base URL 填:https://www.wanmoapi.com/v1
  6. API Key 填:你的 sk-...
  7. 模型名 填适合翻译的模型。
  8. 保存设置。

沉浸式翻译 OpenAI Compatible 配置示意

先用低并发和短网页验证,再逐步增加使用量。示意图中的 API Key 已打码,真实排障截图不要截取隐私网页正文。

推荐设置

设置建议
模型先选成本较低、速度稳定的文本模型
并发新手先调低,稳定后再增加
上下文保持默认,避免长网页超限
令牌单独创建 immersive-translate 令牌

验证方式

  1. 打开一篇短网页。
  2. 只翻译一小段或当前页面的一部分。
  3. 查看是否返回译文。
  4. 到控制台调用日志确认请求成功。

如果短网页成功,再尝试长网页或整页翻译。

常见问题

长网页翻译很贵

网页会被拆成多段请求,每段都消耗 token。建议使用成本合适的模型,并给插件单独设置令牌额度。

翻译中途失败

常见原因是并发过高、网页过长、模型上下文不够或网络中断。先降低并发,改翻译短段落。

在线调试台成功,插件失败

重点检查插件里的 Base URL 是否填到 /v1,模型名是否手动填对。

翻译质量不稳定

不同模型的翻译风格不同。可以在插件提示词中明确“保持术语、不要意译代码、保留 Markdown 结构”等要求。

下一步:限流与并发常见问题排查