NextChat 接入中转站:设置里填接口地址,自己部署的用 BASE_URL
按 NextChat 的官方说明整理:在客户端的设置里选模型服务商,填中转站的接口地址、key 和自定义模型名;自己部署时用 BASE_URL、OPENAI_API_KEY、CUSTOM_MODELS 几个环境变量。讲清地址为什么不带 /v1、模型列表怎么增减、为什么一定要设访问密码。
本文根据公开分享整理,本站尚未实测。操作前请对照文末的原始来源。
NextChat(原名 ChatGPT-Next-Web)是开源的 AI 对话应用,可以自己部署成网页,也有桌面客户端。接中转站有两种场景,做法不一样:
| 场景 | 在哪里配 |
|---|---|
| 用现成的客户端或别人部署好的网页 | 应用的 设置 里,填接口地址和 key |
| 自己部署一个 | 部署环境的环境变量 |
两种场景有一条共同的规则:OpenAI 兼容接口的地址不带 /v1。官方说明里 BASE_URL 的默认值是 https://api.openai.com,后面没有 /v1,路径由 NextChat 自己补。
如果你还没弄清中转站是什么、有哪些风险,先读中转站是什么和用中转站有什么风险;选站可以看中转站排行榜。
开始之前:从中转站拿到三样东西
| 需要什么 | 说明 |
|---|---|
| 接口地址 | OpenAI 兼容接口的地址;用 Claude 的话,再看它有没有单独的 Anthropic 接口地址 |
| 模型名 | 中转站模型页上写的名字,一字不差 |
| API key | 在中转站的控制台创建,多数站只显示一次 |
场景一:在设置里填
这一节的界面步骤出自中转站一方的接入文档,官方的说明文件主要讲的是部署。
打开 NextChat,点左下角的设置图标。找到 模型服务商 的下拉菜单,选一个服务商,再填下面几项:
| 项目 | 用 OpenAI 兼容接口 | 用 Anthropic 原生接口 |
|---|---|---|
| 模型服务商 | OpenAI | Anthropic |
| 接口地址 | https://你的中转站地址,不带 /v1 |
中转站的 Anthropic 接口地址 |
| API Key | 中转站的 key | 中转站的 key |
| 自定义模型名 | 要用的模型,多个用英文逗号隔开 | 同左 |
填好之后,这些模型会出现在设置页下方的 模型 (model) 下拉框里,选一个,回到主界面就可以对话了。
两点说明:
- 地址多写了
/v1会报错。 按中转站一方的文档,这时的报错是Unsupported OpenAI API endpoint,原因是路径重复了,去掉/v1就好。以酷站AI 为例,它给 OpenAI SDK 用的地址是https://api.koozhan.com/v1,在 NextChat 里要填的是https://api.koozhan.com。 - 自定义模型名通常要填。 NextChat 自带的模型列表是按各家官方接口准备的,中转站上的模型名常常不一样,要自己填进去才选得到。
场景二:自己部署,用环境变量
官方说明里写着,这个项目的大多数配置都通过环境变量来设置。接中转站用到的几个:
| 环境变量 | 说明 |
|---|---|
OPENAI_API_KEY |
必填。填中转站的 key;多个 key 用英文逗号隔开,会随机轮流使用 |
BASE_URL |
OpenAI 接口的代理地址。默认 https://api.openai.com |
CUSTOM_MODELS |
控制模型列表,见下文 |
DEFAULT_MODEL |
更改默认模型 |
CODE |
访问密码,见下文 |
ANTHROPIC_API_KEY、ANTHROPIC_URL |
用 Anthropic 原生接口时填 key 和地址 |
一个最小的例子:
OPENAI_API_KEY=你的key
BASE_URL=https://你的中转站地址
CUSTOM_MODELS=-all,+gpt-6.1-sol,+claude-sonnet-5-5
DEFAULT_MODEL=gpt-6.1-sol
CODE=一串足够长的访问密码
在 Vercel 这类平台上部署时,官方说明提醒:增加或修改环境变量后要重新部署,改动才生效。
官方还有一条针对地址的提示:遇到 SSL 证书问题时,把 BASE_URL 的协议改成 http。这是针对你自己搭的、没有配好证书的代理说的;正规的中转站都是 https,不要为了省事改成 http,那样 key 会明文传输。后半句是我们的提醒,不是官方的原话。
用 CUSTOM_MODELS 控制模型列表
写法是:用 + 增加一个模型,用 - 隐藏一个模型,用 模型名=展示名 改显示的名字,之间用英文逗号隔开。
| 写法 | 效果 |
|---|---|
+gpt-6.1-sol |
把这个模型加到列表里 |
-gpt-3.5-turbo |
把这个模型从列表里去掉 |
claude-sonnet-5-5=Claude Sonnet |
列表里显示成 Claude Sonnet |
-all,+gpt-6.1-sol |
先禁用全部,再只启用这一个 |
接中转站时,用 -all 开头最省心:列表里只留中转站实际能用的模型,使用的人不会选到一个不存在的。
模型能看图却发不了图片时,官方提供了 VISION_MODELS:把模型名填进去,多个用逗号隔开,这些模型就会被当作有视觉能力。
一定要设访问密码
官方说明里对 CODE 有一条警告:不填的话,任何人都可以直接使用你部署后的网站,可能导致你的 token 被很快消耗完。
自己部署的站,key 是放在服务器上给所有访问者共用的。网址一旦被别人知道,没有密码就等于把中转站的余额公开了。所以:
CODE一定要设。可以用逗号隔开设多个密码,分给不同的人。- 密码要足够长。官方的提醒是最好 7 位以上,否则会被暴力猜出来。
- 不想让访问者填他们自己的 key,可以把
HIDE_USER_API_KEY设成 1。
常见问题
| 现象 | 检查什么 |
|---|---|
报 Unsupported OpenAI API endpoint |
中转站一方的说法:接口地址多写了 /v1,去掉 |
| 模型下拉框里没有想用的模型 | 设置里的“自定义模型名”或环境变量 CUSTOM_MODELS 有没有填 |
| 提示模型不存在或无权访问 | 模型名是否和中转站的完全一致;这把 key 能不能用这个模型 |
| 改了环境变量没变化 | 有没有重新部署 |
| 余额掉得很快,自己没怎么用 | 有没有设 CODE;密码是否泄露。先到中转站把 key 换掉 |
| 发不了图片 | 用 VISION_MODELS 把模型标成有视觉能力 |
接上之后
- 验证拿到的是不是真模型。 能对话不等于给你的是它声称的模型。用同一把 key 到 Veridrop 检测,背景见中转站怎么掺假。
- 别靠问模型“你是谁”来判断,见问“你是什么模型”为什么验证不了真假。
- 在别人部署的 NextChat 网页里填 key,等于把 key 交给了那个网页。 填之前先确认这个站是谁部署的,来路不明的不要填。
- 其他客户端的接法:Cherry Studio 接入中转站、Chatbox 接入中转站。