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 模型,网关会自动做协议翻译,见 兼容矩阵。

在设置里配置#

  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_keyKey 是否复制完整(共 76 字符);可在 Key 详情页 重新查看
400 model_not_found模型 ID 拼写,须与 模型列表 一致
402 quota_exceeded余额不足。所有 Key 共享同一账户余额,到 充值页 充值
网页版报网络 / 跨域错误见上方「在设置里配置」的说明

错误码完整说明见 错误码。

其他客户端#