在 NextChat 里使用珂艾网关

能用。 打开「自定义接口」，填地址和密钥，再按格式加模型。地址带不带 /v1 取决于版本。
整理日期：2026-10-19 ｜相关：配置三要素 · 按任务选模型

一、地址填法：两种版本，正好相反

NextChat 各版本对「接口地址」的处理不同，这是最容易踩的坑：

你的版本	填什么	说明
字段叫接口地址 / API 代理 URL，且说明里提到自动拼接	`https://turbo.apimax.host`	它自己拼 `/v1/chat/completions`
字段叫接口地址，没提自动拼接	`https://turbo.apimax.host/v1`	需要你带上

一秒钟判断法：填 https://turbo.apimax.host/v1 保存后发消息。

正常回复 → 对了

报 404 或路径出现 /v1/v1/ → 去掉 /v1 重试

不用纠结哪个版本该填什么，试一次就知道。这是最快的判断方式。

二、配置步骤

打开 NextChat，点左下角设置（齿轮图标）。

找到 自定义接口（Custom Endpoint）开关，打开。

填三栏：

字段	填什么
接口地址	`https://turbo.apimax.host/v1`（按第一节判断）
API Key	你的 `sk-` 密钥
自定义模型	见第三节

保存，回对话页，在顶部模型下拉里选中模型。

发一句话测试。

三、自定义模型怎么写（有格式要求）

NextChat 的自定义模型不是随便写个名字就行，有固定语法：

+模型ID@提供方=显示名

最简写法（只用 OpenAI 提供方时，省略 @）：

+claude-sonnet-5-5=Claude Sonnet 5.5,+deepseek-v4-flash=DeepSeek V4 Flash,+gemini-3.8-flash=Gemini 3.8

符号	作用
`+`	新增一个模型，必须有
`,`	分隔多个模型
`=` 左边	真实模型 ID，必须和网关完全一致
`=` 右边	显示名，随便起
`@OpenAI`	指定走哪个提供方（多提供方时用）

如果只写模型名不加 +，它不会出现在下拉列表里。

四、自部署版：环境变量

Docker 示例：

环境变量里的 BASE_URL 通常要带 /v1；如果启动后 404，改成裸域名再试。

五、验证是否真的通了

发送：

你好，用一句话介绍自己

结果	说明
✅ 正常回复	通了
`404` / `/v1/v1/`	地址填法要换（第一节）
`401`	密钥错或带空格
自定义模型添加后无响应	模型 ID 和网关不一致，或格式缺了 `+`
一直转圈	网络或代理

六、推荐模型搭配

用途	模型 ID	显示名建议
日常对话	`claude-sonnet-5-5`	Claude Sonnet 5.5
便宜大批量	`deepseek-v4-flash`	DeepSeek V4 Flash
看图片	`gemini-3.8-flash`	Gemini 3.8 Flash
复杂推理	`claude-opus-5-5`	Claude Opus 5.5

显示名写清楚用途（比如「Claude - 写代码」），模型多了以后更好选。

七、常见报错

现象	原因	解决
自定义接口开关找不到	版本较老	升级到最新版
`404`	地址多写或少写 `/v1`	换另一种填法
模型不出现在下拉里	自定义模型格式错	每条以 `+` 开头，逗号分隔
选了模型但报未授权	该模型不在令牌分组内	换模型或调分组
`401`	密钥错	重新复制核对
自部署改了环境变量无效	容器没重启	`docker restart`

八、计费与分组

项目	信息
计费方式	按量计费（按输入 / 输出 token 结算）
特点	默认会把整个会话历史带上，长会话成本累积快
建议	用完一个话题就「新建对话」，别一直续着

实际单价以价格页为准。

九、相关阅读

同类客户端：Chatbox · LobeChat · Cherry Studio

搞不清填什么：配置三要素

选模型：按任务选模型

报错排查：配置报错对照表

十、更新记录

日期	改了什么
2026-10-19	重写。原篇仅 132 字（两张截图）。补自定义模型的 `+模型@提供方=显示名` 语法、地址两种填法的实测判断法、自部署环境变量

在 NextChat 里使用珂艾网关

一、地址填法：两种版本，正好相反#

二、配置步骤#

三、自定义模型怎么写（有格式要求）#

四、自部署版：环境变量#

五、验证是否真的通了#

六、推荐模型搭配#

七、常见报错#

八、计费与分组#

九、相关阅读#

十、更新记录#