ChatGPT Sidebar 接入API中转站配置教程

# ChatGPT Sidebar 配置教程（接入中转站）

> **适用对象**：浏览器扩展 **ChatGPT Sidebar**（官网 `chatgpt-sidebar.com`，Chrome / Edge）  
> **中转站地址**：`https://api.zaimod.com`  
> **关键一句**：URL 这一栏只填**纯域名**，**不要**带 `/v1`——插件会自己拼  
> **目标**：侧边栏能正常对话，划词能翻译/解释

---

## 一、这个插件的 URL 只填纯域名

前面几篇教程里，有的要填到 `/v1`，有的要填完整 `/v1/chat/completions`。**ChatGPT Sidebar 属于第三类：只填域名，剩下的它自己拼。**

原文那句「将 url 修改为 `https://api.openlux.ai`」——**这一处的格式是对的**，不用改结构，只换域名即可。

### 1.1 三类客户端，别记混

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

### 1.2 多加一段会怎样（实测）

在 `api.zaimod.com` 上分别请求：

| 插件实际拼出的地址                                                         | 返回                                                   |
| ----------------------------------------------------------------- | ---------------------------------------------------- |
| `POST https://api.zaimod.com/v1/chat/completions` ✅                | **401 `Invalid token`**——路径对、只差鉴权                    |
| `POST https://api.zaimod.com/v1/v1/chat/completions`（你自己多加了 `/v1`） | **404 `Invalid URL (POST /v1/v1/chat/completions)`** |
| `POST https://api.zaimod.com/chat/completions`（如果插件不补版本段）          | **200 + 一整页 HTML**（打到站点前端），插件报解析失败                   |

所以判断标准很简单：**报 404 且地址里出现两次 `/v1`，就是地址栏自己多写了一段。**

### 1.3 顺带确认：跨域不是问题

浏览器扩展从后台发请求，理论上会带一个 `chrome-extension://` 的 Origin。实测本中转站的预检响应是：

```
HTTP/1.1 204 No Content
Access-Control-Allow-Origin: *
Access-Control-Allow-Headers: *
Access-Control-Allow-Methods: GET,POST,PUT,DELETE,OPTIONS
```

**预检通过，扩展可以直连**。如果你那边报跨域，问题一般在本机网络、公司代理或浏览器策略，不在中转站。

---

## 二、开始之前

### 2.1 准备清单

| 项目       | 应该填什么                    | 说明                                      |
| -------- | ------------------------ | --------------------------------------- |
| 接入方式     | 第三项 **`OpenAI API key`** | **默认是第一项官方托管**，不切过去看不到 Key 和 URL 输入框    |
| API Key  | `sk-` 开头的令牌              | 控制台「令牌」页新建，不加 `Bearer ` 前缀              |
| 使用我自己的网址 | **打开**（蓝色为开）             | 不打开，URL 输入框填了也不生效                       |
| URL      | `https://api.zaimod.com`  | **纯域名**，不带 `/v1`、不带 `/chat/completions` |
| 模型       | 下拉里选，或点刷新拉取              | 默认 `gpt-3.5-turbo` 已过时，见第四节             |
| 保存       | 必须点                      | 不点保存，前面填的全是临时状态                         |

### 2.2 先装对插件

商店里叫「ChatGPT Sidebar」的同名插件非常多，图标和名字都很像。**从官网 `chatgpt-sidebar.com` 给出的安装入口进**，别按名字搜了就装。

装好后，浏览器工具栏会出现它的图标，点开就是侧边栏。

---

## 三、操作步骤

原文只有一句「进入设置页面，如图所示修改设置」+ 一张图。按图还原成 7 步：

### 步骤 1 · 打开设置，进「通用配置」

![](/uploads/editor/20261031/img_6ae606c11a0d95.56167376.png)

*设置页左侧导航：通用配置 / 搜索页面 / 侧边栏 / 快速查询 / 联系我们。三项接入方式在最上方*

点插件图标进侧边栏后，找**齿轮图标（设置）**；也可以在浏览器扩展管理页点「扩展选项」。进入后左侧导航默认就在 **「通用配置」**。

### 步骤 2 · 接入方式切到第三项「OpenAI API key」

页面上半部分是「如何访问 ChatGPT 并在任何地方使用它」，下面有三个单选：

| 选项                            | 谁在用                                  | 选不选       |
| ----------------------------- | ------------------------------------ | --------- |
| ChatGPT Sidebar（推荐给大家）        | 插件官方的托管服务，**每天 30 条免费查询额度**，超出需升级高级版 | ❌         |
| ChatGPT 网络应用                  | 需要 ChatGPT Plus 账号并保持登录              | ❌         |
| **OpenAI API key（推荐软件开发者使用）** | **用自己的 Key 走自己的接口**                  | ✅ **选这个** |

**这一步是原文完全没提、却最致命的一步**：停在第一项时，页面下面是官方额度说明，根本没有 Key 输入框和 URL 输入框，读者会以为"我的界面怎么不一样"。

### 步骤 3 · 填 API Key

选中第三项后，出现 **`API Key`** 输入框（截图里显示为一串圆点）。把 `sk-` 令牌**原样粘进去**：

- 不要加 `Bearer ` 前缀；
- 不要带引号；
- 注意别把复制时带上的首尾空格、换行一起粘进来（这是 401 的常见原因）。

### 步骤 4 · 打开「使用我自己的网址」

在「模型」下面有一个开关 **「使用我自己的网址」**，把它拨到**打开**（蓝色）。

这个开关是总闸：关着时，插件走它自己的服务端；打开后，下面才会出现 **`URL`** 输入框，请求才会发到你填的地址。

### 步骤 5 · 填 URL（纯域名）

在 **`URL`** 里填：

```
https://api.zaimod.com
```

三个不要：

- **不要**加 `/v1` → 否则变成 `/v1/v1/chat/completions`，404；
- **不要**加 `/chat/completions` → 同理；
- **不要**用 `http://` → 会 301 跳 https，POST 可能被改写。

> 截图里输入框已经预置了 `https://` 前缀，后面的域名被作者打码了。**前缀有就不用重复输**；如果你的输入框是空白的，就整段填全。

### 步骤 6 · 选模型

「模型」下拉里选你要用的模型；下拉右侧那个**圆形箭头按钮是刷新**——点它会重新拉取一次模型列表（列表来自中转站的 `/v1/models`）。

默认值是 `gpt-3.5-turbo`，2023 年的型号，上游基本已下线，**不要直接用**，见第四节。

### 步骤 7 · 点「保存」，然后验收

点 **`保存`** 按钮。没点保存就切走页面，前面的填写会丢。

**验收三步，逐级确认**：

- [ ] 侧边栏里问一句「你是谁」，**能正常流式输出回答**；
- [ ] 回到控制台的**日志 / 用量**页，能看到这次调用记录（说明请求真的走了中转站）；
- [ ] 随手选中一段英文，**划词翻译能出中文**（说明同一个配置在划词功能里也生效）。

> 只看"保存成功"不算通——保存只是存了字符串，不会验证接口。要看第二、三条。

---

## 四、模型：默认值不能用，刷新有前提

| 现象                          | 原因                   | 处理                  |
| --------------------------- | -------------------- | ------------------- |
| 用了默认 `gpt-3.5-turbo`，报模型不存在 | 该型号已下线               | 换成控制台里现存的型号         |
| 下拉里翻不到想要的模型                 | 列表是缓存，或被分组过滤         | 点下拉右侧的**刷新**按钮重新拉一次 |
| 刷新后列表还是很少                   | 你的令牌所属**分组**只放行了这些模型 | 去控制台给分组加模型，或换分组     |

模型列表本质是 `GET /v1/models` 的结果（需带 `Authorization: Bearer sk-…`）。你可以先用 curl 自查这个令牌能看到哪些模型，再去插件里对照，能省很多来回。

---

## 五、关于 Key 的那句说明

截图里官方写着：

> 您的 API 密钥存储在您的浏览器本地，绝不会发送到其他任何地方。

这句话要分两层读，原文没区分：

- **对插件官方来说是成立的**：它不会把你的 Key 上传到 `chatgpt-sidebar.com` 的服务器。
- **但打开「使用我自己的网址」之后**，Key 会以 `Authorization: Bearer sk-…` 的形式**随每个请求发到你自己填的那个地址**——也就是中转站。这不是漏洞，是这条链路本身的样子。

实际影响：

- 中转站能看到的，就是你的提问内容和这个令牌，和任何 API 客户端一样；
- 别在公共电脑的浏览器里长期存 Key；浏览器扩展的本地存储清缓存/换设备就会丢，届时重新填一次即可；
- 敏感页面（网银、公司内部系统）用划词功能时留意一下，划词会把选中的文本发出去。

---

## 六、配置速查表

| 字段       | 值                                           |
| -------- | ------------------------------------------- |
| 接入方式     | `OpenAI API key`（第三项）                       |
| API Key  | `sk-xxxxxxxx`（不加 `Bearer `）                 |
| 使用我自己的网址 | 打开                                          |
| URL      | `https://api.zaimod.com`                     |
| 模型       | 控制台现存型号（下拉选择或点刷新拉取）                         |
| 保存       | 必须点击                                        |
| 插件实际请求   | `https://api.zaimod.com/v1/chat/completions` |

---

## 七、常见问题

| 现象                                               | 原因                            | 处理                            |
| ------------------------------------------------ | ----------------------------- | ----------------------------- |
| 找不到 API Key / URL 输入框                            | 接入方式还停在第一项「ChatGPT Sidebar」   | 切到第三项 `OpenAI API key`        |
| 填了 URL 但请求还是走官方额度                                | 「使用我自己的网址」开关没打开               | 打开开关（变蓝）                      |
| `404 Invalid URL (POST /v1/v1/chat/completions)` | URL 里自己多写了 `/v1`              | 只填 `https://api.zaimod.com`    |
| 返回一大堆 HTML / 解析失败                                | 请求打到了站点前端页面，路径不对              | 同上，去掉多余路径                     |
| `401` / 鉴权失败                                     | Key 错、被删、多粘了空格                | 重新复制令牌，确认首尾干净                 |
| 保存后配置又变回官方                                       | 没点保存，或点了别处切走                  | 重新设置并点 `保存`                   |
| 模型列表刷新不出来                                        | 令牌无效，或分组没放行任何模型               | 先用 curl 测 `/v1/models`，再回插件刷新 |
| 回答到一半断流                                          | 网络中断或中转站超时                    | 换模型重试；持续出现就查控制台日志             |
| 划词功能不生效                                          | 划词相关开关在「搜索页面 / 侧边栏 / 快速查询」子页里 | 去对应子页开启，并确认当前站点未被排除           |
| 报跨域 / CORS                                       | 非中转站问题（预检已实测 204 通过）          | 检查本机代理、公司网络、其他拦截类扩展           |
| 装完发现界面和截图不一样                                     | 装到了同名山寨插件                     | 从官网入口重装                       |

---

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

原文全篇 **179 字符**：一句官网链接 + 一句「修改 url」+ 一张图。逐条：

1. **没说要先把接入方式切到第三项**：这是全篇最关键的遗漏。停在默认的第一项时，Key 和 URL 输入框**根本不存在**，读者会以为是版本差异。已单列为步骤 2 并附三种方式的对比表。
2. **没提「使用我自己的网址」这个总开关**：不开它，URL 填了也不生效，且**不会报错**，只是静默走回官方服务。
3. **没提必须点「保存」**：填完直接关页面就白填了。
4. **没说清 URL 只能填纯域名**：原文只给了示例地址，读者若参照别的教程（比如沉浸式翻译要填 `/v1/chat/completions`）就会写出 `/v1/v1/…` 并拿到 404。已补三派系对照与实测结果。
5. **默认模型 `gpt-3.5-turbo` 已过时**：截图里就是它，照抄基本报模型不存在。已补第四节，含刷新按钮与分组限制。
6. **没解释「刷新」按钮**：下拉右侧的圆形箭头是重新拉取模型列表，原文一字未提，读者会以为是装饰。
7. **截图下半部分被裁掉**：图里最后只露出「注意…」几个字，后面的说明看不到。已在本篇补齐相关注意事项（模型、隐私、保存）。
8. **免费额度的归属没说明**：「每天 30 条免费查询」只属于第一项官方托管；选第三项用的是**你自己在中转站的余额**。很多人以为装了插件就有免费额度。
9. **Key 的隐私边界被过度简化**：官方文案「绝不会发送到其他任何地方」在开启自定义 URL 后不再字面成立。已在第五节说明清楚，避免读者误判。
10. **标题只有产品名、没有目的**：`浏览器插件ChatGPT Sidebar` → 改为《ChatGPT Sidebar 配置教程（接入中转站）》。
11. **没提醒同名插件泛滥**：商店里叫这个名字的插件很多，装错就全篇对不上。已在 2.2 加了官网入口提醒。

---

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

| 项目               | 原地址                            | 现地址                                         |
| ---------------- | ------------------------------ | ------------------------------------------- |
| 原文唯一一处地址（URL 一栏） | `https://api.openlux.ai`       | `https://api.zaimod.com`（**纯域名，不带 `/v1`**）   |
| 截图里的 URL         | `https://` + 打码域名              | `https://api.zaimod.com`                     |
| 插件实际请求           | 未提及                            | `https://api.zaimod.com/v1/chat/completions` |
| 模型列表（刷新按钮拉的）     | 未提及                            | `https://api.zaimod.com/v1/models`           |
| 官网               | `https://chatgpt-sidebar.com/` | 不变（与中转站无关）                                  |

**迁移提示**

- 令牌要在 `api.zaimod.com` 重新生成；旧平台令牌在新域名下返回 `401 Invalid token`。
- 换地址后如果侧边栏还报旧错误，**刷新一次页面**或重载扩展（扩展会缓存配置）。
- 控制台的日志页是判断"请求到底走没走中转站"最可靠的依据，比看插件界面准。

---

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

上一篇：沉浸式翻译接入 GPT 翻译（中转站）{else}上一篇：没有了下一篇：ChatGPT-on-WeChat 配置教程{else}下一篇：没有了