沉浸式翻译配置自定义 API 教程（OpenAI 兼容接口）
让沉浸式翻译插件走你自己的 API 端点：添加自定义 AI 翻译服务的步骤、模型名填写、每秒请求数设置与常见失败原因。
内容复核中：以下为保留的旧稿，不代表本站接入实测；配置、价格与模型信息请以对应产品当前官方文档为准。
沉浸式翻译是主流的网页双语翻译插件，支持自定义 AI 翻译接口。用自己的 API 端点后，翻译质量和额度都由自己掌控。这篇记录完整配置。
前置条件
- 浏览器已安装沉浸式翻译扩展
- 一个 OpenAI 兼容的 API 端点（Base URL + Key）
配置步骤
第 1 步：打开设置
点击浏览器里的沉浸式翻译图标 → 设置 → 翻译服务（或「AI 翻译服务」）。
第 2 步：找到 OpenAI 兼容入口
在服务列表里选择 OpenAI（或「自定义 AI 专家 / 兼容接口」，版本不同叫法略有差异），点击展开配置：
- APIKEY：填你的 Key
- 自定义 API 接口地址：勾选启用，填你的端点地址
第 3 步：地址写法
沉浸式翻译的地址要求和多数工具不同——它通常需要完整路径到 /v1/chat/completions：
https://你的端点/v1/chat/completions如果你填了 /v1 就报 404，补全到 /chat/completions 再试。这是这个插件配置里第一大坑。
第 4 步：选择模型
在「模型」下拉里填入你的端点支持的模型 ID。翻译任务推荐用轻量模型：速度快、成本只有旗舰的几分之一，翻译质量几乎无差。
第 5 步：调整请求频率
设置里可以调「每秒最大请求数」。免费端点或限速严的端点调到 2-5；不限速的可以调高，长网页的翻译速度会明显加快。
第 6 步：验证
保存后随便打开一个英文网页，看是否出现双语对照。第一次生效可能有几秒延迟。
实用设置建议
- 默认服务与悬浮球：把自定义服务设为默认翻译服务，悬浮球一键切换
- 鼠标悬浮翻译：设置 → 鼠标悬浮，按住某键指向段落即翻译，配合自定义端点体验很好
- PDF 翻译：也走同一个配置，学术论文场景实用
- Prompt 定制：进阶用户可以自定义翻译提示词，对术语一致性要求高的场景（比如技术文档）值得调
常见问题
配置后不生效
- 确认选中的「目标语言」和网页语言不同
- 确认该服务被设为「默认翻译服务」
- 刷新页面（设置保存后已打开的页面不会自动应用）
间歇性失败，部分段落没翻译
每秒请求数超了端点的限制。调低并发或换限速宽松的端点。
报 401 / 余额不足
同报错对照表的通用排查，多数是 Key 复制不完整或端点余额耗尽。