很多人把中转站的 Key 拿到手,填进 NextChat 却一直转圈或者直接报错,回头怀疑是站点的问题,其实八成是接口地址和模型名没对上。这篇按「先填哪几项、每一项填什么、报错先查什么」的顺序走一遍,顺带说清哪些情况不是配置问题,免得你在客户端里反复折腾。
很多人拿到中转站的 Key,第一反应是「赶紧填进 NextChat 试试」,结果要么一直转圈,要么弹个红字报错,回头就怀疑是站点挂了。其实八成的问题出在客户端这一侧:接口地址写成了完整对话路径,或者模型名自己顺手简写了。这篇按「先填哪几项、每项填什么、报错先查什么」的顺序走一遍,把容易踩的坑一次说清。
NextChat 的优点是把配置权交给你自己,代价就是它不会替你做校验。所以你填进去的每一个字符都要跟站点说明对得上。下面按设置项、地址与模型名、排查顺序、什么时候不是配置问题、接通后的收尾,逐节讲。
自定义接口在设置里填哪几项
- 自定义接口开关
- 设置里必须先把这项打开,不开的话下面地址填了也不生效,等于白填
- 接口地址
- 填站点给的 Base URL 部分,不要带结尾的 /chat/completions,由客户端自己拼
- API Key
- 从站点后台复制,注意别把前后空格一起带进去
- 模型名
- 必须原样抄站点模型列表里的字符串,一个字符都不能改
- 模型显示名
- 随便起,只用来在下拉框里认出来,不影响请求
四个必填项里,前三个任意一个错了就连不上:地址错会 404,Key 错会 401,模型名错会提示模型不存在。显示名是唯一可以自由发挥的字段,别把它和信息字段混起来。多个模型就在下方加多条自定义模型,一条一个模型名,不要把两个名字塞进同一行用逗号隔开。
- 先确认自定义接口开关是打开的,很多「填了没用」都是开关没开;
- 接口地址只填到域名和公共前缀那一段,路径留给客户端拼;
- Key 用复制不用手动敲,注意首尾别多空格;
- 模型名从站点模型列表复制,别凭记忆写;
- 每条自定义模型单独一行,加几条就填几条。
地址和模型名这两处最容易填错
地址要不要带 /v1,是问得最多的一处。多数中转站两种写法都兼容,但总有一部分只认其中一种,填错了返回 404。稳妥的做法是先照站点说明原样抄,不确定时两种都试一次,看哪个能出字。这一步没有通用答案,具体以你手上那家站点的接入说明为准。
| 容易填错的地方 | 常见表现 | 怎么改 |
|---|---|---|
| 地址带了 /chat/completions | 404 或路径不存在 | 删掉结尾,只留到公共前缀 |
| 地址漏了 /v1 而站点只认这版 | 404 | 照说明补上或去掉 /v1 再试 |
| 模型名自己简写了 | 提示模型不存在 | 从模型列表原样复制 |
| Key 前后带空格 | 401 | 重新复制粘贴一遍 |
| 两条模型写在同一行 | 只有第一个能用 | 拆成两条自定义模型 |
模型名和显示名是两回事。模型名要发给服务端,必须精确;显示名只出现在你的下拉框里,写「主力」「备用」这种都行。同一站点如果同时提供 OpenAI 和 Anthropic 两套协议,先确认 NextChat 这一处走的是哪一套,别把另一套的地址填过来,否则协议对不上也是连不上的。
连不上时的排查顺序
报错不要一上来就怀疑站点,按固定顺序查最快。先换一个最简单的模型名试一次,能排除「只是某个模型下线」这种情况;再读报错本身,401 类多半是 Key 或额度问题,404 类多半是地址路径,一直转圈最后超时多半是网络。顺序错了容易在无关的选项上反复改。
- 换最简单的模型试把模型名换成站点列表里最基础那个,能出字说明是原模型的问题,不是配置问题
- 读报错文案分类401 查 Key 和额度,404 查地址路径,超时查网络和代理,分开处理
- 量一下网络延迟到 /tools/speed-test 的站内测速工具跑一次,确认本地能连出去,再回头怀疑配置
- 整段比对地址把已填地址复制出来,和站点说明逐字符对,重点看斜杠、/v1 和结尾
这一轮跑完,多数情况能定位到具体是哪一项。如果四步都过了还是不通,基本可以判断问题不在你填的那些字段上,往下看下一节。
什么情况下不是配置问题
有几类现象看着像配置错,其实和你的填写无关。同一把 Key 在这台机器通、换台机器就不通,问题通常在本地网络或代理;客户端版本太旧,可能不认新的字段格式,先升级再回来填。这类情况继续改地址只会越改越乱。
还有一种更迷惑人的:站点侧在改分组或者临时限速,报错会时好时坏,同一份配置一会儿能通一会儿不能。这种要去看站点公告,而不是回头动客户端。浏览器里直接用同一个地址能通、客户端不通,优先怀疑客户端的请求头或代理设置,而不是地址本身。
- 换机器就不通:查本地网络和代理,别改配置;
- 升级前后表现不同:先升级客户端再填;
- 时好时坏、间断性报错:看站点公告,等它恢复;
- 浏览器能通、客户端不通:查客户端代理和请求头;
- 所有模型都报同一个错:地址或 Key 整体有问题,从这两项查起。
接上之后顺手做的两件事
能出字不等于稳。随便发一句话确认有回复之后,再发一段长一点的内容,看会不会中途断流——短句和长回复走的路径不完全一样,能连通但会断的情况不少见。这一步花不了一分钟,却能在正式用之前把问题暴露出来。
第二件事是把当前配置留一份。截图或者把地址、模型名记在本地,换机器、重装客户端时直接照抄,不用再翻站点说明重新对一遍。中转站的接入地址和可用模型会变,具体以站内当时的说明为准,到 /sites 看站点分组、到 /price-watch 对价格走势都能帮你判断手上这家还值不值得继续用。
下一步填完先别急着大批量用,去站点导航里对一下这家的接入说明和可信度再决定长期用哪家。→常见问题
接口地址后面要不要加 /v1?
看站点给的说明。多数中转两种写法都收,但客户端拼接路径的方式不同,加错会直接 404。稳妥做法是先用站点说明里那条完整地址,不通再试去掉或补上 /v1,一次只改这一处。
填完一直转圈不出字是什么原因?
先分清是「连不上」还是「连上了但慢」。转圈通常有连接层的问题,换成最简单的模型名、缩短提示词再试一次;如果换了模型就能出字,那问题是那个模型本身或站点侧限速,不是你的地址写错了。
NextChat 里配好的 Key 安全吗?
客户端只是把你的 Key 存在本地配置里,泄露风险主要来自分享配置文件、截图和公共电脑。不要把带 Key 的配置截图发出去,多人共用一台机器时记得配完清理,具体边界可以对照站内安全分区的自查清单。