NextChat 配置教程#
在 NextChat 中通过 Crazyrouter 接入 OpenAI 兼容模型，并完成在线设置、自部署、模型列表和排障配置
NextChat（原 ChatGPT Next Web）适合快速搭建一个轻量、响应快、易自部署的聊天前端。对接 Crazyrouter 时，推荐继续走它默认的 OpenAI 兼容路径，把服务地址指向 Crazyrouter 根域名。通过 NextChat 的 OpenAI 配置项，你可以把请求发到 Crazyrouter：推荐协议：OpenAI-compatible API
推荐接法：NextChat 默认 OpenAI 路线
Base URL：https://api.crazyrouter.com
Note: NextChat 官方 README 把 BASE_URL 定义为 OpenAI API request base URL，示例也是根域名风格；同时本地 http://127.0.0.1:4000/api/status 暴露的 server_address 也是根地址。因此对接 Crazyrouter 时，首次验证优先填写 https://api.crazyrouter.com；如果你的定制版本明确要求更具体路径，再按该版本说明调整。
适合谁用#
想把 Crazyrouter 用于个人或小团队网页聊天的人
使用协议#
推荐协议：OpenAI-compatible APINextChat 对接 Crazyrouter 时，优先填写：https://api.crazyrouter.com
https://api.crazyrouter.com/v1/chat/completions
https://api.crazyrouter.com/v1/models
Tip: NextChat 的不同部署形态里，入口位置可能不一样：在线使用时通常在设置页填写；自部署时更常见的是直接通过环境变量下发。无论 UI 怎么变化，首轮验证都先坚持最小配置：API Key + 根域名 BASE_URL + 单一模型 gpt-5.5。
前置条件#
| 项目 | 说明 |
|---|
| Crazyrouter 账号 | 先在 crazyrouter.com 注册 |
| Crazyrouter token | 建议为 NextChat 单独创建一个 sk-... token |
| NextChat | 在线版或自部署版均可，建议使用当前稳定版 |
| 可用模型 | 至少放行一个当天已实测成功的 OpenAI 兼容聊天模型，如 gpt-5.5 |
5 分钟快速开始#
创建 NextChat 专用 token#
在 Crazyrouter 后台新建 token，名称建议写成 nextchat。首次只放行 gpt-5.5 和 claude-opus-4-8 这类基线模型。打开 NextChat 设置#
进入 NextChat，点击左下角 设置 图标或 Settings 入口。填写接口地址和 Key#
接口地址 / Base URL: https://api.crazyrouter.com指定模型#
模型 / Model 中先手动输入或选择 gpt-5.5。如果当前版本支持自定义模型列表，再补充你需要的其他模型。完成首次验证#
新建一个会话，发送 Reply only OK。收到正常返回后，再逐步加更多模型。自部署快速配置#
| 变量 | 建议值 | 说明 |
|---|
OPENAI_API_KEY | sk-xxx | 默认 Crazyrouter token |
BASE_URL | https://api.crazyrouter.com | 按官方 BASE_URL 用法先填根域名，作为首轮验证基线 |
CUSTOM_MODELS | +gpt-5.5,+claude-opus-4-8,+gemini-3.1-pro | 给前端补充 可选模型 |
HIDE_USER_API_KEY | 1 | 不让终端用户自行输入其他 Key |
推荐模型配置#
| 使用场景 | 推荐模型 | 原因 |
|---|
| 默认主聊天模型 | gpt-5.5 | 当天已实测成功，适合作为 NextChat 主基线 |
| 高质量长文与解释 | claude-opus-4-8 | 更适合长文本和复杂解释 |
| Gemini 备用档 | gemini-3.1-pro | 适合补充第二条兼容性验证路径 |
推荐顺序：先用 gpt-5.5 跑通，再通过 CUSTOM_MODELS 扩展模型列表。Token 设置最佳实践#
| 设 置 | 建议 | 说明 |
|---|
| 专用 token | 必须 | NextChat 不要和 LobeChat、Cursor、Codex 共用 token |
| 模型白名单 | 强烈建议 | 只放行前端真正会显示的模型 |
| IP 限制 | 自部署固定出口时可考虑 | 经常换网络的个人环境谨慎使用 |
| 配额上限 | 强烈建议 | 网页聊天多人使用时消耗可能增长很快 |
| 环境隔离 | 建议 | 演示站、测试站、正式站用不同 token |
| 用户自定义 Key | 建议默认关闭 | 如果你想统一上游和计费，设置 HIDE_USER_API_KEY=1 |
验证清单#
常见错误与修复#
| 现象 | 常见原因 | 修复方式 |
|---|
| 401 unauthorized | token 错误、失效或复制带空格 | 重新生成 token 并替换 |
| 403 / model not allowed | 模型不在白名单里 | 在 Crazyrouter token 设置中放行对应模型 |
| 404 | 把地址写成完整接口路径，或版本变量名使用错误 | 优先改回 https://api.crazyrouter.com，并检查你的版本使用的是 BASE_URL 还是其他变量名 |
| 自部署后前端界面里看不到相关设置项 | 当前部署方式把配置固定在环境变量里，而不是前端设置页 | 直接检查部署配置中的 OPENAI_API_KEY、BASE_URL、CUSTOM_MODELS |
| 页面里看不到模型 | 没配置 CUSTOM_MODELS，或缓存了旧配置 | 先手动输入 gpt-5.5 验证，再刷新并检查环境变量 |
| 请求能发但模型报错 | 默认模型写错 ，或该模型当前不可用 | 回退到 gpt-5.5 做基线验证 |
| 用户仍能改用自己的 Key | 没开启 HIDE_USER_API_KEY=1 | 在部署环境中补上该变量 |
| 成本增长很快 | 多人共用一个高权限 token | 拆 token、缩小白名单、设置额度 |
性能与成本建议#
如果是公开或半公开部署，尽量隐藏用户自定义 Key 入口
对演示站和正式站分开计费，避免测试流量影响生产额度
遇到消耗异常时，先看 Crazyrouter 日志确认是不是长会话或多人共用造成
FAQ#
NextChat 应该填哪个地址？#
优先填 https://api.crazyrouter.com。为什么这里不建议直接填 /v1？#
因为 NextChat 官方文档对 BASE_URL 给 出的示例就是根域名风格；再结合本地 4000 环境返回的 server_address，先用根域名做首轮验证更稳。第一个推荐模型是什么？#
我必须配置 CUSTOM_MODELS 吗？#
不是必须。你可以先手动输入 gpt-5.5 做验证，确认可用后再补充模型列表。为什么有些部署里只能改环境变量，不能在页面里改？#
因为不同 NextChat 部署方式暴露的设置入口不一样。有些自部署实例会把上游、模型和 Key 固定在环境变量里，前端只负责使用，不负责编辑。自部署时建议隐藏用户自定义 Key 吗？#
Note: 如果你想用最少的部署成本做一个轻量聊天前端，NextChat 是非常合适的；如果你更需要团队协作和复杂功能，LobeChat 或 Dify 往往更适合继续扩展。
原教程截图#
Modified at 2026-09-28 12:48:41
