接入到 沉浸式翻译 (Immersive Translate)

本教程将引导您如何在 沉浸式翻译 插件中配置 灵息 API，利用强大的 AI 模型实现高质量的双语网页翻译。

配置步骤

1. 进入设置页面

点击浏览器插件栏的 沉浸式翻译 图标，点击右上角的 “设置”（齿轮图标）。

2. 添加翻译服务

在左侧菜单选择 “翻译服务”，找到底部的 “添加自定义翻译服务”。

3. 选择自定义 AI

在弹出的界面中，同意协议后，选择 “自定义 AI”。

4. 填写配置信息

请按下图及说明填写核心参数：

参数项	填写内容
自定义翻译服务名称	灵息 AI (或自定义)
自定义 API 接口地址	https://ask.ling.rest/api/v1/chat/completions
APIKEY	您的灵息 API Key (可在灵息控制台获取)
模型	勾选“输入自定义模型名称”，填入 gemini-3-flash-preview-vertex

🚨 关键注意：接口地址

沉浸式翻译的“自定义 AI”要求填写完整的 API 路径：

• ✅ 正确：https://ask.ling.rest/api/v1/chat/completions
• ❌ 错误：https://ask.ling.rest/api/v1 (缺少后缀)

5. 优化性能参数 (可选)

为了获得更好的翻译体验，建议对以下高级选项进行调整：

• 每秒最大请求数：建议设置为 12 到 20。
• 每次请求最大文本长度：建议 2000 左右。
• 每次请求最大段落数：建议 4 到 8。

常见问题

• 翻译报错 404：请检查“自定义 API 接口地址”是否完整包含了 /chat/completions。
• 翻译无响应：请前往 API 测试场 检查您的 API Key 是否有效。
• 模型名无效：请确保填写的模型 ID 与 模型名获取 页面中的 ID 完全一致。

💡 专家建议

沉浸式翻译对速度和文本理解有一定要求，使用 Gemini 3 Flash Preview Vertex 系列模型可以获得更精准的术语翻译和长文理解能力。