跳转到主要内容
NextChat(原 ChatGPT Next Web)适合快速搭建一个轻量、响应快、易自部署的聊天前端。对接 Crazyrouter 时,推荐继续走它默认的 OpenAI 兼容路径,把服务地址指向 Crazyrouter 根域名。

概览

通过 NextChat 的 OpenAI 配置项,你可以把请求发到 Crazyrouter:
  • 推荐协议:OpenAI-compatible API
  • 推荐接法:NextChat 默认 OpenAI 路线
  • Base URL:https://crazyrouter.com
  • 认证方式:sk-... token
  • 推荐首次验证模型:gpt-5.4
NextChat 官方 README 把 BASE_URL 定义为 OpenAI API request base URL,示例也是根域名风格;同时本地 http://127.0.0.1:4000/api/status 暴露的 server_address 也是根地址。因此对接 Crazyrouter 时,首次验证优先填写 https://crazyrouter.com;如果你的定制版本明确要求更具体路径,再按该版本说明调整。

适合谁用

  • 想快速部署一个轻量聊天前端的人
  • 想把 Crazyrouter 用于个人或小团队网页聊天的人
  • 想通过环境变量统一下发默认模型和默认上游的人
  • 想用最少配置先把 OpenAI 兼容路径跑通的人

使用协议

推荐协议:OpenAI-compatible API NextChat 对接 Crazyrouter 时,优先填写:
https://crazyrouter.com
不要填成:
  • https://crazyrouter.com/v1/chat/completions
  • https://crazyrouter.com/v1/models
如果你的 NextChat 某个历史版本要求手动填写更具体的 API host,再按该版本说明调整;首次接入先用根域名做基线验证。
NextChat 的不同部署形态里,入口位置可能不一样:在线使用时通常在设置页填写;自部署时更常见的是直接通过环境变量下发。无论 UI 怎么变化,首轮验证都先坚持最小配置:API Key + 根域名 BASE_URL + 单一模型 gpt-5.4

前置条件

项目说明
Crazyrouter 账号先在 crazyrouter.com 注册
Crazyrouter token建议为 NextChat 单独创建一个 sk-... token
NextChat在线版或自部署版均可,建议使用当前稳定版
可用模型至少放行一个当天已实测成功的 OpenAI 兼容聊天模型,如 gpt-5.4
推荐首批白名单:
  • gpt-5.4
  • claude-sonnet-4-6
  • gemini-3-pro-preview

5 分钟快速开始

1

创建 NextChat 专用 token

在 Crazyrouter 后台新建 token,名称建议写成 nextchat。首次只放行 gpt-5.4claude-sonnet-4-6 这类基线模型。
2

打开 NextChat 设置

进入 NextChat,点击左下角 设置 图标或 Settings 入口。
3

填写接口地址和 Key

在 OpenAI 相关设置中填写:
  • API Key: 你的 sk-...
  • 接口地址 / Base URL: https://crazyrouter.com
4

指定模型

模型 / Model 中先手动输入或选择 gpt-5.4。如果当前版本支持自定义模型列表,再补充你需要的其他模型。
5

完成首次验证

新建一个会话,发送 Reply only OK。收到正常返回后,再逐步加更多模型。

自部署快速配置

Docker 环境常见写法如下:
services:
  nextchat:
    image: yidadaa/chatgpt-next-web
    ports:
      - "3000:3000"
    environment:
      - OPENAI_API_KEY=sk-xxx
      - BASE_URL=https://crazyrouter.com
      - CUSTOM_MODELS=+gpt-5.4,+claude-sonnet-4-6,+gemini-3-pro-preview
      - HIDE_USER_API_KEY=1
常见环境变量说明:
变量建议值说明
OPENAI_API_KEYsk-xxx默认 Crazyrouter token
BASE_URLhttps://crazyrouter.com按官方 BASE_URL 用法先填根域名,作为首轮验证基线
CUSTOM_MODELS+gpt-5.4,+claude-sonnet-4-6,+gemini-3-pro-preview给前端补充可选模型
HIDE_USER_API_KEY1不让终端用户自行输入其他 Key

推荐模型配置

使用场景推荐模型原因
默认主聊天模型gpt-5.4当天已实测成功,适合作为 NextChat 主基线
高质量长文与解释claude-sonnet-4-6更适合长文本和复杂解释
Gemini 备用档gemini-3-pro-preview适合补充第二条兼容性验证路径
推荐顺序:先用 gpt-5.4 跑通,再通过 CUSTOM_MODELS 扩展模型列表。

Token 设置最佳实践

设置建议说明
专用 token必须NextChat 不要和 LobeChat、Cursor、Codex 共用 token
模型白名单强烈建议只放行前端真正会显示的模型
IP 限制自部署固定出口时可考虑经常换网络的个人环境谨慎使用
配额上限强烈建议网页聊天多人使用时消耗可能增长很快
环境隔离建议演示站、测试站、正式站用不同 token
用户自定义 Key建议默认关闭如果你想统一上游和计费,设置 HIDE_USER_API_KEY=1

验证清单

  • API Key 已正确保存
  • Base URL 已设置为 https://crazyrouter.com
  • 第一个模型已设置为 gpt-5.4
  • 第一条会话请求成功返回
  • 若是自部署,CUSTOM_MODELS 已生效
  • 流式输出正常
  • Crazyrouter 后台日志能看到对应请求
  • token 配额和模型白名单符合预期

常见错误与修复

现象常见原因修复方式
401 unauthorizedtoken 错误、失效或复制带空格重新生成 token 并替换
403 / model not allowed模型不在白名单里在 Crazyrouter token 设置中放行对应模型
404把地址写成完整接口路径,或版本变量名使用错误优先改回 https://crazyrouter.com,并检查你的版本使用的是 BASE_URL 还是其他变量名
自部署后前端界面里看不到相关设置项当前部署方式把配置固定在环境变量里,而不是前端设置页直接检查部署配置中的 OPENAI_API_KEYBASE_URLCUSTOM_MODELS
页面里看不到模型没配置 CUSTOM_MODELS,或缓存了旧配置先手动输入 gpt-5.4 验证,再刷新并检查环境变量
请求能发但模型报错默认模型写错,或该模型当前不可用回退到 gpt-5.4 做基线验证
用户仍能改用自己的 Key没开启 HIDE_USER_API_KEY=1在部署环境中补上该变量
成本增长很快多人共用一个高权限 token拆 token、缩小白名单、设置额度

性能与成本建议

  • 默认只开放 gpt-5.4
  • 把高价模型从默认列表中拿掉,按需再加
  • 如果是公开或半公开部署,尽量隐藏用户自定义 Key 入口
  • 对演示站和正式站分开计费,避免测试流量影响生产额度
  • 遇到消耗异常时,先看 Crazyrouter 日志确认是不是长会话或多人共用造成

FAQ

NextChat 应该填哪个地址?

优先填 https://crazyrouter.com

为什么这里不建议直接填 /v1

因为 NextChat 官方文档对 BASE_URL 给出的示例就是根域名风格;再结合本地 4000 环境返回的 server_address,先用根域名做首轮验证更稳。

第一个推荐模型是什么?

先用 gpt-5.4

我必须配置 CUSTOM_MODELS 吗?

不是必须。你可以先手动输入 gpt-5.4 做验证,确认可用后再补充模型列表。

为什么有些部署里只能改环境变量,不能在页面里改?

因为不同 NextChat 部署方式暴露的设置入口不一样。有些自部署实例会把上游、模型和 Key 固定在环境变量里,前端只负责使用,不负责编辑。

自部署时建议隐藏用户自定义 Key 吗?

如果你希望统一控制上游和成本,建议隐藏。
如果你想用最少的部署成本做一个轻量聊天前端,NextChat 是非常合适的;如果你更需要团队协作和复杂功能,LobeChat 或 Dify 往往更适合继续扩展。