NextChat 集成
NextChat(原 ChatGPT-Next-Web)用 BASE_URL 等环境变量部署,或在设置里填自定义接口接入本平台
NextChat(原 ChatGPT-Next-Web)是轻量的开源网页对话应用,也有桌面版。本页步骤按 NextChat 的 README 与源码核对(2026-11-15;最新发布版 v2.16.1,2025-07-29 发布)。
准备 API Key#
在 qd.zsopc.com/dashboard/keys 创建 API Key(sk-gpushare- + 64 位十六进制,创建后可在 Key 详情页随时重新查看)。
部署时配置(推荐)#
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):
-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 模型,网关会自动做协议翻译,见 兼容矩阵。
在设置里配置#
- 设置 → 打开 自定义接口
- 模型服务商 选 OpenAI
- 接口地址:
https://qd.zsopc.com(不带/v1) - API Key: 你的
sk-gpushare-... - 自定义模型名: 填要用的模型 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 详情页 重新查看 |
400 model_not_found | 模型 ID 拼写,须与 模型列表 一致 |
402 quota_exceeded | 余额不足。所有 Key 共享同一账户余额,到 充值页 充值 |
| 网页版报网络 / 跨域错误 | 见上方「在设置里配置」的说明 |
错误码完整说明见 错误码。
其他客户端#
- LobeChat — 可自托管的对话应用
- Open WebUI — 自托管 ChatGPT 风格界面
- Chatbox — 桌面 / 手机客户端
- Cherry Studio — 桌面客户端