在 Chatbox 里使用珂艾网关

能用。 关键是分清你的版本要填「API 域名」还是「Base URL」——填错就是 404。
整理日期：2026-10-19 ｜相关：配置三要素 · 按任务选模型

一、先分清两种字段（最容易错的地方）

Chatbox 不同版本的设置界面对「地址」的叫法不一样，填法正好相反：

你看到的字段	填什么	为什么
API 域名 / API Host（旁边还有「API 路径」）	`https://turbo.apimax.host`	Chatbox 会自己拼 `/v1/chat/completions`
Base URL / 接口地址（只有一个地址框）	`https://turbo.apimax.host/v1`	需要你自己带上 `/v1`

判断方法：看有没有单独的「API 路径」输入框。

有 → 域名填裸域名，路径保持默认 /v1/chat/completions

没有 → 只填一个地址，带上 /v1

🔴 填错的典型症状：404 或路径变成 /v1/v1/chat/completions。遇到就换另一种填法。

二、配置步骤

打开 Chatbox → 设置（左下角齿轮）。

进入模型 / 模型提供方 标签。

新建一个提供方，或编辑现有的 OpenAI API 条目。

按第一节的判断填地址：

API 域名：https://turbo.apimax.host
API 路径：/v1/chat/completions   （保持默认）

或（只有一个地址框时）：

Base URL：https://turbo.apimax.host/v1

API Key 填你的 sk- 密钥（注意首尾不要带空格）。

模型一栏手动填网关模型 ID：

claude-sonnet-5-5

保存，回到聊天界面，在顶部下拉里选中该模型。

发一句话测试。

三、验证是否真的通了

发送：

用一句话介绍你自己

判定标准：

结果	说明
✅ 正常回复	通了
`404` / 路径里出现 `/v1/v1/`	第一节的字段类型判断错了，换填法
`401`	密钥错或带空格
模型不存在	模型 ID 填了官网名
一直转圈	网络或代理问题

四、推荐模型搭配

用途	模型 ID	为什么
日常对话、写作	`claude-sonnet-5-5`	综合最稳
便宜大批量	`deepseek-v4-flash`	单价低，够用
看图片 / 截图	`gemini-3.8-flash`	视觉识别强，便宜
复杂分析	`claude-opus-5-5`	需要深推理时再切
代码	`gpt-5.3-codex`	专门优化过

一个 Key 能调所有模型，所以可以多填几个，按会话切换。

五、桌面版与手机版

平台	说明
桌面版（Win / macOS / Linux）	字段最全，支持多提供方并存
手机版（iOS / Android）	设置项精简，通常只有一个「API 域名」+ Key
网页版	与桌面版一致

手机版一般填裸域名（https://turbo.apimax.host），因为它没有独立的路径字段。

六、常见报错

现象	原因	解决
`404`	域名和路径重复拼了 `/v1`	按第一节换另一种填法
`401`	密钥错 / 带空格 / 已删除	重新复制核对
模型不存在	填了 `GPT-6 Astra` 这类官网名	改成 `gpt-6-astra`
图片传不上去	选了纯文本模型	换 `gemini-3.8-flash`
多模型切换后报错	该模型不在令牌分组内	换模型或调分组
需要科学上网才能用	代理规则问题	见国内能不能直连

七、计费与分组

项目	信息
计费方式	按量计费（按输入 / 输出 token 结算）
特点	长对话会反复带上下文，用量随对话轮次累积
建议	开新话题时新建会话，别在一个会话里聊几十轮

实际单价以价格页为准。

八、相关阅读

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

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

选模型：按任务选模型

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

九、更新记录

日期	改了什么
2026-10-19	重写。原篇仅 223 字。核心改动：区分「API 域名」与「Base URL」两种字段的相反填法，这是 Chatbox 最高频的 404 原因

在 Chatbox 里使用珂艾网关

一、先分清两种字段（最容易错的地方）#

二、配置步骤#

三、验证是否真的通了#

四、推荐模型搭配#

五、桌面版与手机版#

六、常见报错#

七、计费与分组#

八、相关阅读#

九、更新记录#