教程NextChat

NextChat 接入中转站:设置里填接口地址,自己部署的用 BASE_URL

按 NextChat 的官方说明整理:在客户端的设置里选模型服务商,填中转站的接口地址、key 和自定义模型名;自己部署时用 BASE_URL、OPENAI_API_KEY、CUSTOM_MODELS 几个环境变量。讲清地址为什么不带 /v1、模型列表怎么增减、为什么一定要设访问密码。

发布 · 约 5 分钟读完 · 经人工审核()· 本站的内容怎么来的

本文根据公开分享整理,本站尚未实测。操作前请对照文末的原始来源。

本页目录(5 节)
  1. 开始之前:从中转站拿到三样东西
  2. 场景一:在设置里填
  3. 场景二:自己部署,用环境变量
  4. 常见问题
  5. 接上之后

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 把模型标成有视觉能力

接上之后

来源

通过 API 中转站使用这些模型?到 Veridrop 免费检测中转站给你的是不是它声称的模型,或者看看中转站排行榜前 100 名。

相关文章

  • DeepSeek Harness(dsh)接入中转站:添加自定义模型 API,协议和地址怎么填教程 · DeepSeek Harness · 约 9 分钟

    按 DeepSeek Harness 官方文档整理:在“设置 → 模型”里添加模型提供商,切换到“自定义模型 API”,填 Provider ID、中转站地址、协议和 key,再加上模型。讲清三种协议怎么选、密钥存在哪里、中转站拒绝请求时改哪两个兼容开关,以及常见报错怎么查。

  • Chatbox 接入中转站:添加自定义的模型提供方,电脑和手机都能用教程 · Chatbox · 约 5 分钟

    按 Chatbox 官方文档整理:在设置的“模型提供方”里点添加,选 API 类型,填中转站的 key 和主机地址,加上模型后点“检查”。讲清 API 主机和路径怎么分、模型能力怎么勾、一键导入配置要注意什么,以及检查失败时各个错误码的含义。

  • Cherry Studio 接入中转站:添加自定义服务商,地址填到哪一级教程 · Cherry Studio · 约 5 分钟

    按 Cherry Studio 官方文档整理:在“模型服务”里添加自定义服务商,填中转站的 key 和地址,获取模型列表后打开启用开关。讲清地址为什么通常只填根地址、什么时候在末尾加

  • 沉浸式翻译接入中转站:自定义接口地址要写完整路径教程 · 沉浸式翻译 · 约 5 分钟

    按沉浸式翻译官方文档整理:在翻译服务里填中转站的 key、模型名和自定义接口地址,就能用中转站的模型翻译网页。和多数工具不同,这里的地址要写到 /v1/chat/completions 为止。讲清两种填法、出现 429 时怎么调请求数,以及翻译这种用法要留意的费用和隐私。