Skip to content

接入到 沉浸式翻译 ​

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

1. 进入设置页面 ​

点击浏览器插件栏的 沉浸式翻译 图标,在弹出面板的左下角点击 “设置”。

沉浸式翻译入口

2. 添加翻译服务 ​

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

添加自定义服务

3. 选择服务类型 ​

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

选择自定义AI

4. 填写核心配置 ​

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

配置详情

参数项填写内容说明
自定义翻译服务名称灵息 AI方便识别即可
自定义 API 接口地址https://ask.ling.rest/api/v1/chat/completions必须包含 /chat/completions 后缀
APIKEYsk-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 是否有效。