# 沉浸式翻译

沉浸式翻译支持添加自定义 AI 翻译服务。填好接口地址、Key 和模型，就能用 NezhaGate 的模型翻译网页和 PDF。

> https://nezhagate.com/docs/integrations/immersive-translate

按此版本编写：Immersive Translate 1.33

## 添加翻译服务

1. 打开扩展的 **设置** → **翻译服务**，拉到最底部，点 **添加自定义翻译服务**。

2. 类型选 **自定义AI**（不要选「自定义API」，那是另一种协议）。

3. 按下表填写，然后保存。

| 字段 | 填什么 |
| --- | --- |
| **自定义 API 接口地址** | `https://nezhagate.com/v1/chat/completions` |
| **APIKEY** | 你的 NezhaGate API Key |
| **模型** | 点 **设置更多模型**，在 **自定义模型列表** 里写入模型 ID（多个用逗号隔开），再选中它。 |
| **每秒最大请求数** | 建议 3–5（默认 5）。整页翻译会同时发出很多请求，设得太高容易触发限流。 |

## 选什么模型

网页翻译是大量的短请求，适合回答快、不做长思考的模型；思考型模型每一段都会先思考，更慢，输出 token 也更多。例如：

`gemini-3.6-flash-low` · `claude-sonnet-4-6`

## Claude（可选）

也可以使用扩展自带的 **Claude** 翻译服务，选择自定义 Key，把 API 地址填成 `https://nezhagate.com/anthropic/v1/messages`。

## 测试

点 **点此测试服务**，显示 **验证成功** 后，打开任意网页试一下翻译。

## 常见问题

**429，或者翻译到一半失败**

把 **每秒最大请求数** 调低，例如 3。

**401 / 404**

401 是 Key 不对；404 是地址写错了，应为 `https://nezhagate.com/v1/chat/completions`。

**测试服务一直失败**

确认选的是 **自定义AI** 而不是「自定义API」，并且模型 ID 已加入自定义模型列表、已选中。

**油猴脚本版无法发出请求**

脚本头部需要用 `// @connect` 声明 NezhaGate 的域名。