接入到 沉浸式翻译
本教程将引导您如何在 沉浸式翻译 插件中配置 灵息 API,利用强大的 AI 模型实现高质量的双语网页翻译。
1. 进入设置页面
点击浏览器插件栏的 沉浸式翻译 图标,在弹出面板的左下角点击 “设置”。

2. 添加翻译服务
- 在左侧菜单选择 “翻译服务”。
- 找到 “添加自定义翻译服务”(如果已添加其他服务,可能需要向下滚动查找)。

3. 选择服务类型
在弹出的服务商列表中,找到并选择 “自定义 AI”(通常是第一个图标)。

4. 填写核心配置
请参考下图及表格填写关键参数。这是最关键的一步,请仔细核对。

| 参数项 | 填写内容 | 说明 |
|---|---|---|
| 自定义翻译服务名称 | 灵息 AI | 方便识别即可 |
| 自定义 API 接口地址 | https://ask.ling.rest/api/v1/chat/completions | 必须包含 /chat/completions 后缀 |
| APIKEY | sk-xxxxxxxx | 您的灵息 API 密钥 |
| 模型 | gemini-3-flash-preview-vertex | 需勾选“输入自定义模型名称”后手动输入 |
🚨 关键注意:接口地址
沉浸式翻译的“自定义 AI”要求填写完整的 API 路径:
- ✅ 正确:
https://ask.ling.rest/api/v1/chat/completions - ❌ 错误:
https://ask.ling.rest/api/v1(会报 404 错误)
5. 优化并发设置 (推荐)
灵息 API 支持高并发,为了提升翻译速度,建议调整下方的高级参数:
- 每秒最大请求数:建议设为
10或更高(默认值较保守)。 - 每次请求最大文本长度:推荐
1200左右。
配置完成后,点击页面右上角的 “保存” 即可开始使用。
常见问题
- 翻译报错 404:请检查“自定义 API 接口地址”是否完整包含了
/chat/completions。 - 翻译无响应:请前往 API 测试场 检查您的 API Key 是否有效。