NextChat 接入 Models Hub:自定义接口配置
在 NextChat(ChatGPT-Next-Web)官方站或自部署实例里开启自定义接口,填入 Models Hub 的地址与 API Key,附验证步骤与常见报错排查。
NextChat(即 ChatGPT-Next-Web)是一款开源的跨平台 AI 对话客户端,支持网页、桌面端与自部署。把它的自定义接口指向 Models Hub 后,对话请求会用 Models Hub 的额度调用你指定的模型。本文分两种情况:直接用官方站临时切换接口,或自部署实例长期使用。只讲接入,不讲 NextChat 本身的其它功能。
三样东西
接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com(若报错见下方说明)、一个模型名。
准备
- 一个 Models Hub API Key。在控制台的 令牌页 创建,令牌所在分组要能访问你打算用的模型。
- 想临时用:打开 NextChat 官方站 即可,不用安装。想长期自部署,准备一台能跑 Docker 或 Vercel 的环境,参考 官方部署文档。
推荐模型
| 用途 | 模型名 | 定价 | 实时状态 |
|---|---|---|---|
| 日常对话首选 | claude-sonnet-4-6 | 查看价格 | 可用率与延迟 |
| 复杂问题与长对话 | gpt-5.5 | 查看价格 | 可用率与延迟 |
| 便宜快速,适合日常问答 | gpt-5.4-mini | 查看价格 | 可用率与延迟 |
模型名以 模型定价页 为准。
情况一:直接用官方站
-
打开 app.nextchat.dev,点左下角设置图标进入设置页。
-
在「模型」区域找到 自定义接口(英文界面为 Custom Endpoint)开关并打开,会出现 接口地址(OpenAI Endpoint)与 API Key 两个输入框。
-
接口地址 先填:
https://modelsok.com发消息如果报错(常见是 404),改成带
/v1的:https://modelsok.com/v1 -
API Key 填你的 Models Hub API Key。
-
回到对话页,在模型下拉框里选上表中的模型名;如果列表里没有,尝试在模型输入框里直接手动输入模型 ID(以当前版本界面为准)。
官方站的配置只存在浏览器本地,清缓存或换设备需要重新填一次。
情况二:自部署实例
自部署可以把配置写进环境变量,团队共用时更省事。以 Docker 为例:
docker run -d -p 3000:3000 \
-e BASE_URL="https://modelsok.com" \
-e OPENAI_API_KEY="你的 Models Hub API Key" \
-e CUSTOM_MODELS="+claude-sonnet-4-6,+gpt-5.5,+gpt-5.4-mini" \
yidadaa/chatgpt-next-web| 环境变量 | 作用 |
|---|---|
BASE_URL | 接入地址;源码只要求以 http(s):// 开头,不强制带 /v1,同「情况一」的排查方法一样先不带再看报错 |
OPENAI_API_KEY | Models Hub API Key,多个 Key 用逗号分隔可轮询 |
CUSTOM_MODELS | 控制模型列表:+ 添加、- 隐藏、name=显示名 改显示名,逗号分隔;⚠️ 用 -all 先清空默认列表再加回(如 -all,+claude-sonnet-4-6)这种写法未在当前版本实机确认,以你部署的版本实际效果为准 |
改完环境变量后重启容器生效。
验证
在对话框里选中你配置的模型,发一句「用一句话介绍当前项目」。能正常回复即接通。再打开 Models Hub 控制台的 用量日志,几秒内会出现一条对应模型名的请求。
常见报错
| 现象 | 原因 | 处理 |
|---|---|---|
| 发消息报 404 | 接口地址少了或多了 /v1 | 两种都试一次,把能通的固定下来 |
401 / Incorrect API key | Key 复制不完整,或令牌被禁用 | 到 令牌页 重新复制 |
| 模型下拉里没有想要的模型 | 官方站没手动输入模型 ID;自部署没在 CUSTOM_MODELS 里加 +模型名 | 按情况一步骤 5 或情况二环境变量表处理 |
回复很慢或报 429 | 触发限流,通常是并发过高 | 稍后重试;持续出现联系客服提额 |
| 自部署改了环境变量不生效 | 容器没有重启 | docker restart 或重新部署 |
更多排查见 故障排查。
常见问题
计费方式? 按请求实际消耗的输入与输出 token 计费,价格看各模型定价页,用量日志里能看到每条请求的明细。
和直接用官方 API 有什么区别? 请求格式一致,只是接口地址换成了 Models Hub;一个 Key 能用多家厂商的模型,不需要各自注册账号。
怎么切换模型? 在对话框顶部的模型下拉框里直接选,自部署环境需要先在 CUSTOM_MODELS 里加入该模型才会出现在列表中。