NextChat 接入第三方 API 快速教程：Vercel 与 Docker 部署配置
用 NextChat 搭建私有 AI 聊天客户端，并通过第三方 API 调用多模型。本文覆盖 Vercel、Docker、已有部署修改和常见问题。
NextChat 是一个开源 AI 聊天客户端，原名 ChatGPT Next Web。它支持 Vercel 一键部署、Docker 自建，也可以作为团队内部的轻量聊天入口。
由于 NextChat 支持 OpenAI 兼容接口，把它接到 NixAPI 后，就可以在一个私有聊天界面里使用 GPT、Claude、Gemini、DeepSeek、MiniMax 等模型。
本文重点提醒一件事：NextChat 的 BASE_URL 填 https://nixapi.com，不要带 /v1。
准备工作
你需要：
- 一个 NixAPI API Key
- 一个 NextChat 部署方式：Vercel、Docker 或已有部署
- 一个访问密码
CODE，避免别人直接使用你的服务
NixAPI API Key 可以在 NixAPI 控制台 创建。模型列表和价格可以查看 NixAPI 模型价格页。
为什么 BASE_URL 不带 /v1
很多 OpenAI 兼容工具需要填写：
https://nixapi.com/v1
但 NextChat 是例外。NextChat 会在内部自动拼接 /v1，所以环境变量应填写：
https://nixapi.com
如果你写成 https://nixapi.com/v1，实际请求可能变成 /v1/v1，从而出现 404 或 Failed to fetch。
方式一：Vercel 一键部署
NextChat 支持从 GitHub 仓库一键部署到 Vercel。部署时需要填写环境变量。
建议填写：
| 环境变量 | 值 | 说明 |
|---|---|---|
OPENAI_API_KEY | nix-your-api-key | NixAPI API Key |
BASE_URL | https://nixapi.com | 注意不带 /v1 |
CODE | 自定义密码 | 访问 NextChat 时使用 |
部署完成后，Vercel 会提供一个 *.vercel.app 域名。打开页面，输入 CODE，发送一条消息测试即可。
方式二：Docker 启动
如果你希望部署在自己的服务器上，可以用 Docker：
docker run -d -p 3000:3000 \
-e OPENAI_API_KEY=nix-your-api-key \
-e BASE_URL=https://nixapi.com \
-e CODE=my-password-123 \
yidadaa/chatgpt-next-web
启动后访问：
http://localhost:3000
如果部署在服务器上，把 localhost 换成服务器 IP 或域名。
方式三：Docker Compose
创建 docker-compose.yml：
version: '3'
services:
nextchat:
image: yidadaa/chatgpt-next-web
ports:
- "3000:3000"
environment:
OPENAI_API_KEY: nix-your-api-key
BASE_URL: https://nixapi.com
CODE: my-password-123
restart: unless-stopped
启动：
docker compose up -d
同样注意：BASE_URL 不带 /v1。
方式四：已有部署中手动修改
如果你已经有 NextChat，不需要重新部署。打开 NextChat 设置页，找到自定义接口相关配置：
- API Key 填写 NixAPI API Key
- 接口地址填写
https://nixapi.com - 保存后回到聊天页测试
旧版本字段可能叫 OpenAI Endpoint、API URL 或「自定义接口」。只要是 OpenAI API 地址字段，都按不带 /v1 的规则填写。
切换模型
NextChat 里通常可以在对话顶部选择模型。如果列表没有你想要的模型，可以在设置里添加自定义模型名称。
可先尝试：
gpt-5.4claude-sonnet-4-20250514claude-opus-4-7gemini-3-pro-previewdeepseek-v4
模型名称必须和 NixAPI 支持的 ID 一致。建议从 NixAPI 支持的模型列表页 复制。不同模型价格不同，团队多人使用前建议查看 NixAPI 模型价格页。
NixAPI 当前有限时充值兑换率：￥0.80 = $1.00。如果你准备给团队部署 NextChat，可以先评估用量。
面具与常用模板
NextChat 的「面具」可以理解为预设 System Prompt。你可以给常见工作流创建模板：
- 代码审查助手
- 周报生成助手
- 中英文翻译助手
- 产品需求整理助手
- 客服回复草稿助手
每个面具可以绑定不同模型。例如代码审查使用 claude-sonnet-4-20250514，日常改写使用成本更低的模型。
常见问题
1. 部署后提示 Failed to fetch
优先检查 BASE_URL。NextChat 中应填写：
https://nixapi.com
不要填写：
https://nixapi.com/v1
2. 发送消息后报 401
API Key 无效或复制不完整。重新从 NixAPI 控制台 复制 Key。
3. 报模型不存在
模型 ID 拼写错误。打开 NixAPI 支持的模型列表页 复制准确名称。
4. Vercel 部署后如何更新？
同步你 Fork 的 NextChat 仓库，上游更新后 Vercel 通常会自动重新部署。更新前建议备份环境变量。
5. 聊天记录会存到哪里？
NextChat 默认把聊天记录存在浏览器本地。需要注意的是，模型调用内容仍会发送到 API 端，这是所有远程模型调用都需要考虑的数据边界。
小结
NextChat 接入 NixAPI 的关键是 OPENAI_API_KEY 和 BASE_URL=https://nixapi.com。这篇教程里只有 NextChat 的 Base URL 不带 /v1，请和其他 OpenAI 兼容工具区分开。配置完成后，你就可以用 NextChat 搭建一个私有多模型聊天入口。