沉浸式翻译接入 API中转平台GPT模型翻译教程

# 沉浸式翻译 接入 GPT 翻译（中转站）

> **适用对象**：沉浸式翻译浏览器扩展（Chrome / Edge / Firefox），界面为 v1.5.x 一版  
> **中转站地址**：`https://api.zaimod.com`  
> **关键一句**：自定义 API 地址要填**完整端点** `https://api.zaimod.com/v1/chat/completions`  
> **目标**：任意英文网页一键出中英对照，且译文不夹解释、不夹空白行

---

## 一、先记住这一条：这里要填「完整端点」

这是本批教程里**唯一一个要求填完整路径**的客户端，和别的工具正好相反。

| 派系            | 谁负责拼路径                     | 地址栏该填什么                                         | 代表客户端                                         |
| ------------- | -------------------------- | ----------------------------------------------- | --------------------------------------------- |
| A · 只填域名      | 程序自己拼                      | `https://api.zaimod.com`                         | Claude Code、Gemini CLI、NextChat、ChatBox 0.4.0 |
| B · 填到 `/v1`  | SDK 只拼 `/chat/completions` | `https://api.zaimod.com/v1`                      | Dify、Cline、Cursor、LobeChat、CherryStudio       |
| **C · 填完整端点** | **谁都不拼，原样请求**              | **`https://api.zaimod.com/v1/chat/completions`** | **沉浸式翻译（本教程）**                                |

沉浸式翻译的输入框旁边就写着一句提示：**「请添加具体带有路径的网址」**。意思是它把你填的字符串**当成最终 URL 直接 POST**，不补任何东西。

### 1.1 四种填法的实测结果

在 `api.zaimod.com` 上逐个发 `POST`（带一个无效令牌）：

| 地址栏填写                                         | 实际请求                        | 返回                               | 后果                        |
| --------------------------------------------- | --------------------------- | -------------------------------- | ------------------------- |
| `https://api.zaimod.com`                       | `POST /`                    | **200 + 整页 HTML**                | 打到站点前端页面，扩展解析失败           |
| `https://api.zaimod.com/v1`                    | `POST /v1`                  | **404 `Invalid URL (POST /v1)`** | 缺最后一段，明确报错                |
| `https://api.zaimod.com/v1/chat/completions` ✅ | `POST /v1/chat/completions` | **401 `Invalid token`**          | 路径正确、只差鉴权                 |
| 同上但**末尾多一个 `/`**                              | 307 跳转到去掉斜杠的地址              | —                                | 一般能跟随，但个别环境会丢 body，**别加** |

看到 `401 Invalid token` 才是"填对了、只是 Key 不对"。看到 `404` 就是路径少了一段。

---

## 二、开始之前

### 2.1 准备清单

| 项目         | 应该填什么                                       | 说明                                           |
| ---------- | ------------------------------------------- | -------------------------------------------- |
| 翻译服务       | `OpenAI`                                    | 用 OpenAI 兼容协议接中转站，**不要**选 `Claude` 或 `DeepL` |
| 服务提供商      | **`自定义 API Key`**                           | 不是上面的「Pro 会员」，选错会一直提示开通会员                    |
| APIKEY     | `sk-` 开头的令牌                                 | 控制台「令牌」页新建，不加 `Bearer ` 前缀                   |
| 自定义 API 地址 | `https://api.zaimod.com/v1/chat/completions` | **必须带完整路径**，见第一节                             |
| 模型         | 控制台里真实存在的模型 ID                              | 默认的 `gpt-3.5-turbo` 已过时，见 2.2                |
| 每秒最大请求数    | 建议 `3`～`5`                                  | 默认的 10 对中转站偏高，容易 429，见第四节                    |

### 2.2 模型别用默认值

截图里「模型」下拉默认是 **`gpt-3.5-turbo`**。这是 2023 年的型号，上游基本都已下线，直接用大概率报「模型不存在 / 无可用渠道」。

两个动作：

1. 先看下拉里有没有你要的型号（新版本一般会列出常见型号）；
2. **没有就勾上「输入自定义模型名称」**，勾了才会出现可输入的文本框，然后手动填控制台里的模型 ID。

> 这个复选框是**隐藏开关**：不勾时字段是只读下拉，你填不进去，也不会报错——很多人卡在这里以为是扩展坏了。

### 2.3 对模型的要求

翻译场景对模型的要求比想象中高，因为扩展靠一段 System Prompt 约束输出格式（截图里那段）：

> *You are a professional, authentic machine translation engine. You only return the translated text, without any explanations.*  
> （你是一个专业、地道的机器翻译引擎。只返回译文，不要任何解释。）

能力弱的模型会违反这个约束，表现为：

- 译文后面附一句"以下是翻译结果："之类的解释；
- 该翻的地方留空、或多出一堆空行；
- 把网页里的专有名词也一并意译，导致术语错乱。

遇到这几种情况，换更强的模型比调参数有用。

---

## 三、操作步骤

原文用红笔在截图上标了 ①②③④，但没有文字说明。按图还原成 6 步：

### 步骤 1 · 打开设置，进「翻译服务」

点浏览器工具栏的沉浸式翻译图标 → **设置**，左侧导航点 **「翻译服务」**。

左侧导航完整顺序：基本设置 / 翻译服务 / AI 专家 / 视频字幕 / 输入框增强 / 鼠标悬停 / 悬浮球 / 快捷键 / 进阶设置 / 导入导出 / 关于。

### 步骤 2 · 翻译服务选 OpenAI

![](/uploads/editor/20261031/img_6ae605717ac896.28791425.png)

*「翻译服务」下拉里选 OpenAI；右侧「服务提供商」选「自定义 API Key」，然后填 APIKEY*

下拉里会列出微软翻译、谷歌翻译、Claude、Yandex、腾讯交互翻译等。**选 `OpenAI`**——不是因为它专指 OpenAI 官方，而是因为它走的是 OpenAI 兼容协议，中转站正好是这个协议；选 `Claude` 会走 Anthropic 协议，配置方式不同（见常见问题最后一条）。

同时在「目标语言」里确认是 **简体中文**。

### 步骤 3 · 服务提供商选「自定义 API Key」，填 APIKEY

在「选择一个服务提供商」下面有两个单选：

| 选项               | 说明             | 选不选   |
| ---------------- | -------------- | ----- |
| 沉浸式翻译 Pro 会员（推荐） | 官方托管，需要登录且付费   | ❌     |
| **自定义 API Key**  | 用自己的 Key 和接口地址 | ✅ 选这个 |

选完下面会出现 **`APIKEY`** 输入框，把 `sk-` 令牌**原样粘进去**：不要加 `Bearer ` 前缀、不要带引号、注意别把首尾空格一起粘进来。

### 步骤 4 · 展开「更多自定义选项」

![](/uploads/editor/20261031/img_6ae60581a18083.61920919.png)

*页面下方有一个折叠项「展开更多自定义选项 👇」，点开它，地址栏就藏在里面*

这一步是原文最容易漏的地方——**默认是收起的**，不点开根本看不到「自定义 API 地址」在哪，很多人翻遍页面也找不到。

### 步骤 5 · 填自定义 API 地址、模型、请求频率

点开后依次是四项：

![](/uploads/editor/20261031/img_6ae6058d81c0f6.20955622.png)

*展开后的四项：每次请求最大文本长度 1200、每次请求最大段落数 1、自定义 API 地址、System Prompt*

**自定义 API 地址**填：

```
https://api.zaimod.com/v1/chat/completions
```

- 一定是 `https://`，不要 `http://`（会 301 跳转，POST 可能被改写）；
- 结尾**不要**加 `/`；
- 不要写成 `/v1/v1/chat/completions`。

**模型**：按 2.2 处理，必要时勾「输入自定义模型名称」手填。

**每秒最大请求数**：默认 10，建议先改成 **3～5**，稳定后再往上调（原因见第四节）。

### 步骤 6 · 保存并真的翻译一段

点页面右下角 **保存**。然后打开任意一个英文网页，点扩展图标 → **翻译**（或按快捷键）。

**验收要看四件事，缺一不算通**：

- [ ] 页面上出现**原文 / 中文对照**的双语段落，而不是只有原文；
- [ ] 译文是通顺中文，**没有**"以下是翻译："这类多余解释；
- [ ] 段落之间没有大量空白行、没有整段漏译；
- [ ] 回到 `api.zaimod.com` 控制台的**日志/用量**页，能看到刚才这批请求的记录。

> 只看到"保存成功"不代表通了——保存只是存了个字符串。新版扩展在服务配置下方有 **「测试服务」** 按钮，点一下能直接测通断；老版没有这个按钮，就用上面四条验收。

---

## 四、四个参数怎么调

![](/uploads/editor/20261031/img_6ae6059b309022.44454756.png)

| 参数            | 默认        | 作用                          | 建议                      |
| ------------- | --------- | --------------------------- | ----------------------- |
| 每次请求最大文本长度    | `1200`    | 单次请求最多送多少字符。调大 → 请求数少但单次响应慢 | 保持 1200；网络差可降到 800      |
| 每次请求最大段落数     | `1`       | 一次送几段。调大 → 请求数少，但丢段/串段的概率上升 | 保持 1；长文嫌慢可试 2～3         |
| 每秒最大请求数       | `10`      | 并发上限                        | **先设 3～5**，出现 429 再加/再减 |
| System Prompt | 英文翻译引擎提示词 | 约束模型只输出译文                   | **不要动**，除非确定自己在做什么      |

关于并发：沉浸式翻译翻一页会**同时发很多个请求**（每段或每批一个），默认 10 路并发对官方 OpenAI 是常态，对中转站就可能触发限流。现象是**部分段落一直是原文、过一会儿才补上**，或者控制台里出现一批 429。这不是配置错，是并发超了——把「每秒最大请求数」调小即可。

---

## 五、配置速查表

| 字段         | 值                                           |
| ---------- | ------------------------------------------- |
| 翻译服务       | `OpenAI`                                    |
| 服务提供商      | `自定义 API Key`                               |
| APIKEY     | `sk-xxxxxxxx`（不加 `Bearer `）                 |
| 自定义 API 地址 | `https://api.zaimod.com/v1/chat/completions` |
| 模型         | 控制台实际模型 ID（不勾"自定义模型名称"就选不到）                 |
| 每秒最大请求数    | `3`～`5`                                     |
| 每次请求最大文本长度 | `1200`                                      |
| 每次请求最大段落数  | `1`                                         |
| 目标语言       | 简体中文                                        |

---

## 六、常见问题

| 现象                     | 原因                                 | 处理                                                                                  |
| ---------------------- | ---------------------------------- | ----------------------------------------------------------------------------------- |
| 请求失败 / 报解析错误           | 地址栏只填了域名，请求打到了站点前端页面（200 + HTML）   | 补成 `https://api.zaimod.com/v1/chat/completions`                                      |
| `404 Invalid URL`      | 地址只填到 `/v1`，少了 `/chat/completions` | 补全最后一段                                                                              |
| 地址末尾带了 `/`             | 307 重定向，个别环境丢请求体                   | 删掉末尾斜杠                                                                              |
| `401` / 鉴权失败           | Key 错、被删、多粘了空格或 `Bearer `          | 重新复制令牌，确认前后无空格                                                                      |
| `429` / 部分段落不翻译        | 并发超过中转站限流                          | 「每秒最大请求数」降到 3，或把「最大段落数」调到 1                                                         |
| 下拉里没有我要的模型             | 字段是只读下拉                            | 勾上「**输入自定义模型名称**」再手填                                                                |
| 提示模型不存在 / 无可用渠道        | 用了默认 `gpt-3.5-turbo`，或该模型不在分组内     | 换控制台里实际存在、分组有权限的模型                                                                  |
| 译文里夹着"以下是翻译"之类的话       | 模型没遵守 System Prompt                | 换能力更强的模型；不要改 System Prompt 的结构                                                      |
| 译文大段空白、段落错位            | 一次塞太多段落                            | 「最大段落数」调回 1，「最大文本长度」降到 800                                                          |
| 一直提示开通会员               | 服务提供商选成了「Pro 会员」                   | 改选「自定义 API Key」                                                                     |
| 找不到「自定义 API 地址」        | 「展开更多自定义选项」是收起的                    | 点开它（步骤 4）                                                                           |
| 想走 Claude 原生协议         | 当前走的是 OpenAI 兼容通道                  | 翻译服务改选 `Claude`，其自定义地址填 `https://api.zaimod.com/v1/messages`（实测该路径 POST 返回 401，说明存在） |
| 换了新版本界面，找不到 OpenAI 这一项 | 新版入口改为「添加自定义翻译服务 / 自定义 AI」         | 填法不变：API Key + **完整** `/v1/chat/completions` 地址 + 模型                                |

---

## 七、附录 A · 原文勘误

原文全篇 **263 字符**：三张图 + 一句「填写 <https://api.openlux.ai/v1/chat/completions」。逐条：>

1. **那句地址没说是填在哪一栏**：原文只有一行「填写 …/v1/chat/completions」，读者不知道该贴到「APIKEY」还是「API 地址」。已明确为「展开更多自定义选项 → 自定义 API 地址」。
2. **没提关键前提：这一栏要填完整路径**：这是全篇唯一的技术要点，原文靠读者自己从截图里看出 `…/v1/chat/completions`。已提炼成第一节，并给出四种填法的实测对比（域名 → 200 HTML；`/v1` → 404；完整路径 → 401）。
3. **没提「展开更多自定义选项」是折叠的**：不点开看不到地址栏，这是最常见的"找不到地方填"的原因。已单列为步骤 4。
4. **默认模型 `gpt-3.5-turbo` 已过时**：截图里就是它，照抄基本报模型不存在。已补 2.2 节，含「输入自定义模型名称」这个隐藏开关的用法。
5. **「输入自定义模型名称」复选框一字未提**：不勾它，模型字段是只读下拉，填不进新模型，且**不会报错**。
6. **每秒最大请求数默认 10 对中转站偏高**：原文没提，但这是"部分段落翻不出来 / 429"的直接原因。已给出 3～5 的建议值和现象解释。
7. **没有步骤顺序**：四张图只靠手写红字 ①②③④ 串起来，正文没有任何文字步骤。已拆成 6 步。
8. **没有验收方法**：原文没有说明什么算配置成功。已补四条判据（双语对照 / 无多余解释 / 无大段空白 / 控制台有记录），并说明"保存成功 ≠ 通了"。
9. **没提 Key 的边界**：网页正文会被送到中转站，令牌存在扩展本地存储，换设备/清缓存会丢。隐私敏感页面（网银、内部系统）应关闭翻译。
10. **标题与内容层级不符**：`沉浸式翻译 设置gpt翻译` 读起来像随手记的备忘。已改为《沉浸式翻译 接入 GPT 翻译（中转站）》，并补充适用版本与目标。

---

## 八、附录 B · 地址变更对照

| 项目                         | 原地址                                          | 现地址                                                                |
| -------------------------- | -------------------------------------------- | ------------------------------------------------------------------ |
| 原文唯一一处地址（自定义 API 地址）       | `https://api.openlux.ai/v1/chat/completions` | `https://api.zaimod.com/v1/chat/completions`                        |
| 截图里的地址（域名被打码）              | `https://[打码]/v1/chat/completions`           | `https://api.zaimod.com/v1/chat/completions`                        |
| OpenAI 兼容对话接口              | 同上                                           | `https://api.zaimod.com/v1/chat/completions`                        |
| Claude 原生通道（翻译服务改选 Claude） | 未提及                                          | `https://api.zaimod.com/v1/messages`                                |
| 模型列表接口（脚本自查用）              | 未提及                                          | `https://api.zaimod.com/v1/models`（需带 `Authorization: Bearer sk-…`） |

**迁移提示**

- 令牌要在 `api.zaimod.com` 重新生成；旧令牌在新域名下返回 `401 Invalid token`。
- 改完配置先刷新一下已翻译的页面（扩展会缓存当前页的翻译结果），否则看到的是旧缓存，容易误判没生效。
- 想确认请求真的发出去了，用控制台的日志页对时间点，比看扩展界面可靠。

---

*接口地址：`https://api.zaimod.com`*

上一篇：Claude Dev 接入配置教程{else}上一篇：没有了下一篇：ChatGPT Sidebar 接入配置教程{else}下一篇：没有了