Skip to content

NextChat 接入

NextChat(ChatGPT-Next-Web)是自托管的网页聊天客户端,通过自定义接口地址接入 Router。

  • 协议:OpenAI Chat Completions
  • 接入地址https://routerapi.<你的域名>/v1

准备工作

  1. 登录 Router 控制台,签发一个 Key 并保存明文
  2. 在控制台「快速接入」页记下 OpenAI Chat Completions 协议的接入地址

方式一:部署时环境变量(推荐,自托管管理员)

bash
docker run -d -p 3000:3000 \
  -e BASE_URL="https://routerapi.<你的域名>" \
  -e OPENAI_API_KEY="<你的 Key>" \
  -e CUSTOM_MODELS="+<模型名>" \
  nextchat/chatgpt-next-web
  • BASE_URL不带 /v1 的根地址(NextChat 会自己拼 /v1
  • CUSTOM_MODELS=+<模型名> 把模型加进可选列表

方式二:页面设置(使用者自助)

  1. 打开 NextChat → 左下角设置
  2. 找到 OpenAI 接口相关配置:
    • **接口地址(自定义接口)**填:https://routerapi.<你的域名>
    • API Key 填你的 Key
  3. 自定义模型处添加控制台「可用模型」列表中的模型名
  4. 回到对话页,模型选择刚添加的模型

验证

发一条消息,正常流式回复即接入成功;控制台「调用记录」出现调用明细。

常见问题

Q:404 / 请求路径不存在? NextChat 会在接口地址后自行拼接 /v1/chat/completions——地址里不要自己带 /v1,否则会变成 /v1/v1/...

Q:页面设置改了不生效? 部署时如果通过环境变量锁死了接口配置(BASE_URL 等),页面设置会被覆盖,以部署配置为准。

智能模型路由服务