配置速查
NextChat 只有一个字段需要小心,填错就是 404。
| 配置项 | 填什么 | 容易错在哪 |
|---|---|---|
接口地址 | https://turingapi.space | 不要带 /v1,带了会变成 /v1/v1 |
API Key | 控制台创建的 sk- 密钥 | 别忘了在设置里点确认,部分版本不自动保存 |
自定义模型 | 从 模型列表 复制的模型名 | 写在内置模型名上会 404 |
/v1/chat/completions。你填 https://turingapi.space/v1,最终请求变成 https://turingapi.space/v1/v1/chat/completions,服务端找不到这个路径,返回 404。这和 Cherry Studio 正好相反——所以「两种写法互换一次」是接第三方接口的通用救命手法。前置准备
先准备好密钥,再打开 NextChat 的设置面板。
在 注册页 建账号,控制台「API Keys」新建一把并立刻保存。
打开 模型列表,挑一个并复制准确的模型名。NextChat 的下拉框是它内置的官方模型名,未必和站内一致。
用官方网页版可以直接改设置;自己部署(Vercel / Docker)时环境变量和界面设置会互相覆盖,这点后面会讲。
配置步骤
三步配完,重点是第一步的地址写法。
设置自定义接口 主流程
- 打开「设置 → 自定义接口」
- 接口地址填
https://turingapi.space(结尾不带 /v1) - API Key 填你的
sk-密钥 - 把「模型」下拉切到自定义,填入站内实际模型名
- 关闭设置面板,新建一个对话测试
如果连不通,第一件事就是把地址改成带 /v1 的写法再试一次,反之亦然。
添加自定义模型 容易漏的一步
- 在设置面板找到「自定义模型」输入框
- 填入模型名,多个模型用英文逗号分隔
- 保存后回到对话页,在顶部模型下拉里就能选到
- 模型名必须和站内完全一致,包括连字符和大小写
claude-sonnet-5,gpt-6.1-sol,grok-4.7不填自定义模型的话,界面里只有它内置的官方模型名,选中后请求会带上不存在的模型名,返回 400 或 404。
自部署时配置不生效 特有坑
- 环境变量(如
BASE_URL、OPENAI_API_KEY)只在没有界面设置时生效 - 一旦在界面里保存过设置,界面值优先级更高
- 排查时先清掉界面里的自定义接口设置,再用环境变量启动
自部署常见现象:改了环境变量重启,行为却没变——因为浏览器本地已经存了一份界面设置。
验证是否配置成功
看到这些就说明通了
- 新建对话,随便发一句话
- 回答能流式出现
- 控制台「用量」页出现对应记录
如果界面报错但用量页有记录,说明请求通了,问题在返回格式的解析上,通常是模型名或协议选错。
404 的快速定位
- 打开浏览器开发者工具的 Network 面板
- 发一条消息,找到
chat/completions这个请求 - 看它的完整 URL
https://turingapi.space/v1/chat/completionsURL 里出现两个 /v1 就是地址填错了;出现 /api/openai 之类说明没走自定义接口,还在用它内置的代理。
常见问题
NextChat 的坑几乎全在地址和模型名这两个字段上。
为什么一直 404?
九成是地址多写了一层 /v1。NextChat 会自己拼 /v1,你只需要填 https://turingapi.space。
验证方法:打开开发者工具的 Network,看实际请求的 URL 里有没有两个 /v1。
模型列表里没有我要的模型?
NextChat 的模型下拉是它自己内置的清单,不会从接口拉。你要用别的模型,必须在设置的「自定义模型」里填进去。
能不能同时保留官方和这里的配置?
可以在界面里切换「自定义接口」开关,但同一时间只能生效一套。开源自部署的话,可以用两个环境变量组合起不同实例。
手机上能用吗?
能,Web 版和桌面版共用同一套设置项。移动端浏览器里打开同一个部署地址,重新填一次设置即可,设置存在浏览器本地,不会自动同步。
相关客户端
CCherry Studio
图形界面配置,点「获取模型列表」自动拉取
LLobeChat
代理地址填 /v1,模型列表要手动加
CChatBox
API 模式要选 OpenAI Compatible
通通用 OpenAI 兼容
两种地址写法,互换一次就能解决大半问题
接入过程卡住了?到 QQ 群 1128182538 说明「客户端 + 报错码 + 时间点」,比只说"用不了"好排查得多。其他通用问题见 常见问题。