NextChat （ChatGPT-Next-Web）桌面版与网页版接入中转站配置教程

# NextChat 接入中转站配置教程

> 适用对象：NextChat（ChatGPT-Next-Web / NextChat 桌面版与网页版）  
> 目标：把 NextChat 的请求指向中转站 `https://api.zaimod.com`，并使用中转站提供的模型

---

## 一、开始之前

### 1.1 你需要准备

| 项目       | 说明                                               |
| -------- | ------------------------------------------------ |
| NextChat | 网页版、桌面版、Docker 自建均可，界面一致                         |
| 中转站 Key  | 在 `https://api.zaimod.com` 控制台创建，形如 `sk-xxxxxxxx` |
| 模型 ID    | 从中转站「模型列表」页复制，**必须完全一致**                         |

### 1.2 三个关键值（先记住，后面逐条解释）

| 配置项     | 填什么                     | 易错点                      |
| ------- | ----------------------- | ------------------------ |
| 接口地址    | `https://api.zaimod.com` | **只填域名，不要加 `/v1`**       |
| API Key | `sk-xxxxxxxx`           | **不要自己加 `Bearer ` 前缀**   |
| 自定义模型名  | 控制台里的模型 ID              | 截图里那个名字是**平台私有命名**，照抄必失败 |

> 本篇的地址规则与 LobeChat、Dify、Cline、Cursor 那几篇**正好相反**。原因是 NextChat 的程序里已经写死了 `v1/chat/completions` 这段路径，它会自己拼。详见 2.1。

---

## 二、两个必须先弄清的点

### 2.1 接口地址为什么不能带 `/v1`

NextChat 的请求路径由程序内置，源码里是这样定义的：

```js
export const OpenaiPath = {
  ChatPath: "v1/chat/completions",
  ListModelPath: "v1/models",
  // ...
};
```

发给服务端的地址是 `你的接口地址 + "/" + "v1/chat/completions"`。也就是说：

| 接口地址填                      | 实际请求                      | 结果                               |
| -------------------------- | ------------------------- | -------------------------------- |
| `https://api.zaimod.com`    | `/v1/chat/completions`    | **401 Invalid token**（路径正确，只差鉴权） |
| `https://api.zaimod.com/v1` | `/v1/v1/chat/completions` | **404 Invalid URL**              |
| `https://api.zaimod.com/`   | `/v1/chat/completions`    | 正常（程序会自动去掉末尾斜杠）                  |

实测对照如上，`/v1/v1/...` 返回的是 404 `Invalid URL (POST /v1/v1/chat/completions)`，报错信息里会直接显示出重复的路径，很容易辨认。

> **一句话原则：谁负责拼 `/v1`，谁就不该让用户填。** NextChat 自己拼，所以只填到域名。

### 2.2 「自定义接口」开关不开，填什么都不生效

设置页里「自定义接口」这一栏的**右上角有一个开关**。截图里它是**打开状态**（蓝色小点）。

这个开关控制的是"是否使用你填的地址和 Key"，而不是"地址是否保存"。关闭时：

- 接口地址、API Key 输入框仍然可以编辑、也能保存
- 但程序不会读取它们，请求照旧发往 NextChat 默认地址
- **不报错、不提示**，表现就是"改了跟没改一样"

这是本篇最容易漏的一步，原文未提及。

---

## 三、操作步骤

> 截图来自 NextChat 2024 年 9 月版本（界面左下角版本号所在位置），新版界面布局基本一致。

### 步骤 1 打开设置

点击左侧边栏**最下方的齿轮图标**，右侧滑出「设置 · 所有设置选项」面板。

面板顶部有 `×` 关闭按钮，设置**改完即时保存**，没有"保存"按钮。

### 步骤 2 打开「自定义接口」开关

向下滚动到「自定义接口」分组（副标题：*整合使用自定义 Azure 或 OpenAI 服务*），打开其**右上角的开关**。

![](/uploads/editor/20261031/img_6ae60083bfb173.77308900.png)

*图：设置页「自定义接口」分组，红字为原作者标注的填写顺序*

### 步骤 3 选择模型服务商

「模型服务商 · 切换不同的服务商」保持默认的 **OpenAI**。

选 OpenAI 时，请求走 `/v1/chat/completions`（OpenAI 兼容格式），中转站的 GPT、Claude、Gemini、DeepSeek 都能通过这一个通道调用，模型名原样透传。

> 若想使用 Claude 原生 Messages 协议（支持 thinking、prompt caching 等原生特性），可改选 `Anthropic`，此时程序改走 `v1/messages`。两种服务商的地址**都是只填域名**，因为版本段同样由程序拼接。

### 步骤 4 填写接口地址

「接口地址 · 默认地址外，必须包含 https://」填入：

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

注意三点：

- **不要加 `/v1`**（原因见 2.1）
- 必须写 `https://`，只写域名时程序会自己补 `https://`，但写了 `http://` 不会被纠正，中转站会 301 跳转，POST 请求可能被改写
- 不要加末尾斜杠（加了也不影响，程序会去掉）

### 步骤 5 填写 API Key

「API Key · 使用自定义 OpenAI Key 绕过密码访问限制」填入控制台创建的密钥，形如 `sk-xxxxxxxxxxxxxxxx`。

- **不要加 `Bearer ` 前缀**。程序在发请求时会自己拼 `Authorization: Bearer sk-xxx`，你自己再加就变成 `Bearer Bearer sk-xxx`，直接 401
- 右侧有**眼睛图标**，点击可临时显示明文，用于核对有没有粘贴多余空格
- 填完后这一栏会以圆点形式显示

### 步骤 6 添加自定义模型名

「自定义模型名 · 增加自定义模型可选项，使用英文逗号隔开」填入中转站里的模型 ID：

```
claude-sonnet-4-5-20250929
```

填写要点：

- **多个模型用英文逗号分隔**，不要用中文逗号、不要加空格，例如 `gpt-4o,claude-sonnet-4-5-20250929,deepseek-chat`
- 这里的名字必须与中转站「模型列表」里的 ID **逐字符一致**，差一个字符就是 `model not found`
- 这一栏的作用是"往模型下拉框里**增加**选项"。不填的话，下拉框里只有 NextChat 内置的那批型号，你选不到中转站的私有模型

### 步骤 7 在「模型 (model)」里选中刚添加的模型

「模型 (model)」下拉框现在会多出你刚填的选项，选中它。

选中后下拉框显示为 `模型名(模型名)` 的**重复格式**（例如 `claude-sonnet-4-5-20250929(claude-sonnet-4-5-20250929)`）。这是正常的——括号内是显示名、括号外是实际请求的模型 ID，未单独设置显示名时两者相同，不是你配错了。

> 截图里填的是 `cursor-3-5-sonnet-20240620`，这是该账号平台的**私有命名**（带 `cursor-` 前缀），换一个中转站就对不上。照抄原文这一行必然报 `model not found`，请以你控制台里的实际 ID 为准。

### 步骤 8 返回对话验证

点击面板右上角 `×` 关闭设置，回到对话页发一句测试。

**建议的验收方式**（比"问它 1+1"更可靠）：

1. 回复能正常流式输出，不是报错文案
2. 到中转站控制台 → **日志**，能看到这次请求的记录，模型名与你填的一致
3. 日志里的消耗正常扣减

第 2 条是最硬的证据。只看回复内容，无法区分请求究竟发到了中转站还是发到了别处。

---

## 四、配置速查表

| 字段         | 应填                      | 常见错填                       | 错填后果                          |
| ---------- | ----------------------- | -------------------------- | ----------------------------- |
| 自定义接口（开关）  | **打开**                  | 关闭                         | 配置全部不生效，无提示                   |
| 模型服务商      | `OpenAI`                | 选 Azure                    | 要求填 deployment 名，中转站无此概念      |
| 接口地址       | `https://api.zaimod.com` | `https://api.zaimod.com/v1` | 404 `/v1/v1/chat/completions` |
| API Key    | `sk-xxxxxxxx`           | `Bearer sk-xxxxxxxx`       | 401 `Bearer Bearer`           |
| 自定义模型名     | 控制台模型 ID，英文逗号分隔         | 截图里的 `cursor-*`            | `model not found`             |
| 模型 (model) | 与上一步同名的选项               | 选了内置 `gpt-3.5-turbo`       | 报模型不存在或走错通道                   |

---

## 五、常见问题

**Q1 填完地址，回复为空 / 一直转圈 / 提示解析失败**

八成是接口地址多写了 `/v1`，请求打到了 `/v1/v1/chat/completions`。把 `/v1` 去掉即可。可在浏览器开发者工具（F12）→ Network 里看实际请求 URL 确认。

**Q2 报 401 `Invalid token`**

路径已经对了，问题在密钥：检查是否有多余空格、是否误加了 `Bearer `、是否用了旧平台的 Key（换域名后需在新平台重新生成）。

**Q3 报 404 `Invalid URL`**

看报错里显示的路径。若是 `/v1/v1/...`，是地址多写了 `/v1`；若是别的路径，检查接口地址是否被自动补成了 `http://`。

**Q4 「模型 (model)」下拉里找不到中转站的模型**

- 「自定义模型名」是否已填并回车生效（NextChat 是输入即存，但个别版本需点一下别处）
- 模型名与中转站 ID 是否逐字符一致（大小写、连字符、日期后缀）
- 多个模型时是否用了中文逗号

**Q5 明明改了地址，请求还是发到 OpenAI**

「自定义接口」开关没开。见 2.2。

**Q6 配置在另一台电脑/换浏览器后没了**

NextChat 的设置保存在**浏览器的 localStorage**，换设备、换浏览器、清缓存、无痕模式都会丢失。多端使用时需要各自配置一遍，或改用 Docker 部署并通过环境变量统一配置。

**Q7 网页版能连上吗？会不会跨域失败**

本站已实测：预检 `OPTIONS` 返回 `204`，带 `Access-Control-Allow-Origin: *`、`Allow-Headers: *`，网页版可直连。

但要注意**安全边界**：网页版是浏览器直接请求中转站，Key 会出现在浏览器请求里，任何能打开这台电脑的人都能从开发者工具中看到。公用电脑建议改用桌面版或自建服务端代理。

**Q8 上传图片、联网搜索、插件用不了**

这些是 NextChat 客户端自身的功能，部分依赖官方插件服务，与中转站无关。中转站只负责模型对话。

**Q9 长文对话到一半被截断**

「单次回复限制 (max_tokens)」截图里是 `4000`，这个值限制的是**单次回复长度**，不是上下文长度。需要长输出时调到 8000 以上（前提是所选模型支持）。

**Q10 temperature 和 top_p 怎么设**

截图给的 `0.5` / `1.0` 是通用默认值。两个参数**不要同时改**——需要稳定输出时调低 temperature（0.2~~0.3），需要发散时调高（0.8~~1.0），top_p 保持 1.0 即可。

**Q11 用 Claude 模型，但想用原生协议**

把「模型服务商」从 `OpenAI` 改成 `Anthropic`，此时程序走 `v1/messages`。地址仍只填域名。代价是模型下拉和参数面板会切换为 Anthropic 的参数集，OpenAI 系模型就不能在同一个通道里用了。

---

## 六、原文勘误

原文全文（`nextchat 设置教程`）**120 字符**，构成是：标题、1 张截图、一句用 `***` 包裹的「接口地址填写」。整理时修正/补齐如下：

1. **正文只有一句话，没有任何操作步骤**。从"打开设置"到"验证成功"共 8 步全部缺失，已按截图重建。
2. **`***` 标记污染正文**。原文用 `***接口地址填写： …***` 包裹，在 Markdown 中 `***` 是加粗斜体标记，渲染后整行格式错乱，域名可能被当成强调内容吃掉。已改为正文说明。
3. **标题小写且无适用对象**。`nextchat 设置教程` 未说明是"接入中转站"，也未区分网页版/桌面版，已改为《NextChat 接入中转站配置教程》。
4. **只给了域名，但没解释为什么不能带 `/v1`**。本篇原文的写法是对的（与 LobeChat、Dify 那几篇相反），但读者若参考了别的教程"顺手加 `/v1`"就会 404。已补源码依据与实测对照表。
5. **完全没提「自定义接口」开关**。开关关着时填什么都不生效且无提示，这是本篇最隐蔽的坑。
6. **没写从哪进设置**。入口是左侧边栏最下方的齿轮图标，原文未说明。
7. **截图中的模型名是私有命名**。`cursor-3-5-sonnet-20240620` 带 `cursor-` 前缀，属该账号平台的特定命名，照抄到别的账号必然 `model not found`。已标注需从控制台复制。
8. **模型名已过时**。`claude-3-5-sonnet-20240620` 是 2024 年中的型号，现已下线或改名，示例已换成当前可用的写法。
9. **没写「自定义模型名」的格式要求**。需用**英文逗号**分隔，原文只说"需要自定义模型"，没说怎么加、加几个、用什么分隔。
10. **没提 API Key 不要加 `Bearer ` 前缀**。这一点与扣子工作流那篇正好相反（扣子必须加），用户很容易顺着习惯加错。
11. **没给任何验收判据**。原文只有"填写"二字，没说什么算配置成功。已补三条判据，并以中转站日志为准。
12. **没提配置的存储位置与安全边界**。设置存在浏览器 localStorage，换设备即失效；网页版 Key 在浏览器可见，原文均未提示。
13. **`max_tokens` 默认 4000 会截断长输出**，原文未说明该字段含义。

---

## 附录 A 地址变更对照

| 位置   | 原文档                      | 现文档                     |
| ---- | ------------------------ | ----------------------- |
| 接口地址 | `https://api.openlux.ai` | `https://api.zaimod.com` |

说明：本篇原文给的就是**纯域名**，与 NextChat 程序的实际拼接逻辑一致，因此**只需替换域名，不加 `/v1`**。旧地址仅在本对照表中保留说明。

## 附录 B 各客户端地址粒度对照

同样是接中转站，不同客户端对"地址写到哪一级"的要求完全不同，这是最容易混淆的地方：

| 客户端              | 接口地址填到                     | 由谁拼 `/v1`                  |
| ---------------- | -------------------------- | -------------------------- |
| **NextChat**（本篇） | `https://api.zaimod.com`    | 程序内置 `v1/chat/completions` |
| ChatBox 0.4.0    | `https://api.zaimod.com`    | 程序内置                       |
| LobeChat         | `https://api.zaimod.com/v1` | 用户填                        |
| Dify             | `https://api.zaimod.com/v1` | 用户填（endpoint 字段）           |
| Cline            | `https://api.zaimod.com/v1` | 用户填                        |
| Cursor           | `https://api.zaimod.com/v1` | 用户填（Override Base URL）     |
| Claude Code      | `https://api.zaimod.com`    | 程序拼 `/v1/messages`         |
| Gemini CLI       | `https://api.zaimod.com`    | 程序拼 `/v1beta/...`          |

**判断方法**：在客户端的设置说明里找它的示例值。示例写 `https://api.openai.com` 的，就填纯域名；示例写 `https://api.openai.com/v1` 的，就带 `/v1`。拿不准时，两种都试一次——报 404 且路径里出现两个 `/v1`，就是多了；报解析失败或回复为空，就是少了。

上一篇：ChatBox 接入中转站配置教程{else}上一篇：没有了下一篇：Zotero GPT 插件接入中转站教程{else}下一篇：没有了