图灵 APIAI 大模型 API 中转站

首页 / 客户端配置 / NextChat

NextChat 自定义接口接入图灵 API

NextChat(原 ChatGPT-Next-Web)是开源的网页聊天客户端。它的接口地址有个反直觉的设定:不要填 /v1,因为它会自己拼上去——这是它最大的坑。

网页 / 桌面自带 /v1 拼接开源自部署可用

配置速查

NextChat 只有一个字段需要小心,填错就是 404。

配置项填什么容易错在哪
接口地址https://turingapi.space不要带 /v1,带了会变成 /v1/v1
API Key控制台创建的 sk- 密钥别忘了在设置里点确认,部分版本不自动保存
自定义模型从 模型列表 复制的模型名写在内置模型名上会 404
为什么这里不带 /v1:NextChat 在发请求时会自己拼 /v1/chat/completions。你填 https://turingapi.space/v1,最终请求变成 https://turingapi.space/v1/v1/chat/completions,服务端找不到这个路径,返回 404。这和 Cherry Studio 正好相反——所以「两种写法互换一次」是接第三方接口的通用救命手法。

前置准备

先准备好密钥,再打开 NextChat 的设置面板。

1
创建一个 API 密钥

在 注册页 建账号,控制台「API Keys」新建一把并立刻保存。

2
确认要用哪个模型

打开 模型列表,挑一个并复制准确的模型名。NextChat 的下拉框是它内置的官方模型名,未必和站内一致。

3
想好部署形态

用官方网页版可以直接改设置;自己部署(Vercel / Docker)时环境变量和界面设置会互相覆盖,这点后面会讲。

配置步骤

三步配完,重点是第一步的地址写法。

设置自定义接口 主流程

  1. 打开「设置 → 自定义接口」
  2. 接口地址填 https://turingapi.space(结尾不带 /v1)
  3. API Key 填你的 sk- 密钥
  4. 把「模型」下拉切到自定义,填入站内实际模型名
  5. 关闭设置面板,新建一个对话测试

如果连不通,第一件事就是把地址改成带 /v1 的写法再试一次,反之亦然。

添加自定义模型 容易漏的一步

  1. 在设置面板找到「自定义模型」输入框
  2. 填入模型名,多个模型用英文逗号分隔
  3. 保存后回到对话页,在顶部模型下拉里就能选到
  4. 模型名必须和站内完全一致,包括连字符和大小写
claude-sonnet-5,gpt-6.1-sol,grok-4.7

不填自定义模型的话,界面里只有它内置的官方模型名,选中后请求会带上不存在的模型名,返回 400 或 404。

自部署时配置不生效 特有坑

  1. 环境变量(如 BASE_URL、OPENAI_API_KEY)只在没有界面设置时生效
  2. 一旦在界面里保存过设置,界面值优先级更高
  3. 排查时先清掉界面里的自定义接口设置,再用环境变量启动

自部署常见现象:改了环境变量重启,行为却没变——因为浏览器本地已经存了一份界面设置。

验证是否配置成功

看到这些就说明通了

  1. 新建对话,随便发一句话
  2. 回答能流式出现
  3. 控制台「用量」页出现对应记录

如果界面报错但用量页有记录,说明请求通了,问题在返回格式的解析上,通常是模型名或协议选错。

404 的快速定位

  1. 打开浏览器开发者工具的 Network 面板
  2. 发一条消息,找到 chat/completions 这个请求
  3. 看它的完整 URL
https://turingapi.space/v1/chat/completions

URL 里出现两个 /v1 就是地址填错了;出现 /api/openai 之类说明没走自定义接口,还在用它内置的代理。

常见问题

NextChat 的坑几乎全在地址和模型名这两个字段上。

为什么一直 404?

九成是地址多写了一层 /v1。NextChat 会自己拼 /v1,你只需要填 https://turingapi.space。

验证方法:打开开发者工具的 Network,看实际请求的 URL 里有没有两个 /v1。

模型列表里没有我要的模型?

NextChat 的模型下拉是它自己内置的清单,不会从接口拉。你要用别的模型,必须在设置的「自定义模型」里填进去。

能不能同时保留官方和这里的配置?

可以在界面里切换「自定义接口」开关,但同一时间只能生效一套。开源自部署的话,可以用两个环境变量组合起不同实例。

手机上能用吗?

能,Web 版和桌面版共用同一套设置项。移动端浏览器里打开同一个部署地址,重新填一次设置即可,设置存在浏览器本地,不会自动同步。

相关客户端

还没密钥?注册后直接创建一个 邮箱注册即用,控制台自助创建密钥、查看用量与余额。
免费注册 →

接入过程卡住了?到 QQ 群 1128182538 说明「客户端 + 报错码 + 时间点」,比只说"用不了"好排查得多。其他通用问题见 常见问题。