# NextChat 集成

> NextChat(原 ChatGPT-Next-Web)用 BASE_URL 等环境变量部署,或在设置里填自定义接口接入本平台

来源：https://qd.zsopc.com/docs/integrations/nextchat

> [NextChat](https://github.com/ChatGPTNextWeb/NextChat)(原 ChatGPT-Next-Web)是轻量的开源网页对话应用,也有桌面版。本页步骤按 NextChat 的 README 与源码核对(2026-11-15;最新发布版 v2.16.1,2025-07-29 发布)。

## 准备 API Key

在 [qd.zsopc.com/dashboard/keys](https://qd.zsopc.com/dashboard/keys) 创建 API Key(`sk-gpushare-` + 64 位十六进制,创建后可在 Key 详情页随时重新查看)。

## 部署时配置(推荐)

```bash
docker run -d -p 3000:3000 \
  -e OPENAI_API_KEY=sk-gpushare-xxx \
  -e BASE_URL=https://qd.zsopc.com \
  -e CUSTOM_MODELS=-all,+claude-sonnet-4-6@OpenAI,+gpt-6.1-sol@OpenAI,+deepseek-v4.1-flash@OpenAI \
  -e CODE=你的访问密码 \
  yidadaa/chatgpt-next-web
```

- **`BASE_URL` 不要带 `/v1`**:NextChat 自己拼 `/v1/chat/completions`,写成 `https://qd.zsopc.com/v1` 会变成 `/v1/v1/...`。
- **`CUSTOM_MODELS`**:`-all` 隐藏内置模型,`+模型ID` 添加模型,逗号分隔。`@OpenAI` 后缀让这个模型走上面的 OpenAI 兼容地址。
- **`CODE`**:访问密码,多个用逗号分隔。部署到公网时一定要设,否则任何人都能用你的 Key。
- 不想让用户在页面上填自己的 Key,再加 `-e HIDE_USER_API_KEY=1`。

想让 Claude / Gemini 走原生协议,再加下面几项,并把对应模型的后缀写成 `@Anthropic` / `@Google`(如 `+claude-sonnet-4-6@Anthropic`、`+gemini-3.1-pro-low@Google`):

```bash
  -e ANTHROPIC_URL=https://qd.zsopc.com \
  -e ANTHROPIC_API_KEY=sk-gpushare-xxx \
  -e GOOGLE_URL=https://qd.zsopc.com \
  -e GOOGLE_API_KEY=sk-gpushare-xxx \
```

两个地址同样不带版本号。只用 `@OpenAI` 也能调 Claude / Gemini 模型,网关会自动做协议翻译,见 [兼容矩阵](../reference/compatibility-matrix.md)。

## 在设置里配置

1. **设置** → 打开 **自定义接口**
2. **模型服务商** 选 **OpenAI**
3. **接口地址**: `https://qd.zsopc.com`(不带 `/v1`)
4. **API Key**: 你的 `sk-gpushare-...`
5. **自定义模型名**: 填要用的模型 ID,逗号分隔,如 `claude-sonnet-4-6,gpt-6.1-sol`

> 这一方式适合**桌面版**。网页版开了自定义接口后,请求由浏览器直接发往 API,而本平台的 API 不对第三方网页开放跨域访问,会失败;网页版请用上一节的部署时配置,由 NextChat 的服务端转发。

## 常见问题

| 现象 | 排查 |
|---|---|
| 404 | 地址多写了 `/v1`:`BASE_URL` 和接口地址都只填 `https://qd.zsopc.com` |
| 403 `you are not allowed to use ... model` | 设了 `CUSTOM_MODELS` 后,只有列出的模型可用;把模型加进去 |
| 401 `invalid_api_key` | Key 是否复制完整(共 76 字符);可在 [Key 详情页](https://qd.zsopc.com/dashboard/keys) 重新查看 |
| 400 `model_not_found` | 模型 ID 拼写,须与 [模型列表](../reference/models.md) 一致 |
| 402 `quota_exceeded` | 余额不足。所有 Key 共享同一账户余额,到 [充值页](https://qd.zsopc.com/dashboard/billing) 充值 |
| 网页版报网络 / 跨域错误 | 见上方「在设置里配置」的说明 |

错误码完整说明见 [错误码](../reference/errors.md)。

## 其他客户端

- [LobeChat](./lobechat.md) — 可自托管的对话应用
- [Open WebUI](./open-webui.md) — 自托管 ChatGPT 风格界面
- [Chatbox](./chatbox.md) — 桌面 / 手机客户端
- [Cherry Studio](./cherry-studio.md) — 桌面客户端
