配置速查
ChatBox 的三个字段，前两个是必填。
| 配置项 | 填什么 | 容易错在哪 |
|---|---|---|
API 模式 | OpenAI API Compatible | 选成别的模式不会出现 Host 字段 |
API Host | https://turingapi.space/v1 | 只填到域名 + /v1，不要再往后加路径 |
模型 | 站内实际模型名 | 可在「模型」里手动添加自定义模型 |
如果提示 404：把 API Host 里的
/v1 去掉再试一次。ChatBox 不同版本对 Host 的处理不一致，有的会自己补 /v1。这两种写法互换一次，是判断这类问题的通用办法。前置准备
桌面端和移动端要分别配置，设置不会自动同步。
1
创建一个 API 密钥
在 注册页 建账号，控制台新建密钥并保存。
2
确认要用的模型名
从 模型列表 复制，后面要手动填。
3
决定先配哪一端
建议先配电脑端，跑通了再照着同样的字段配手机端，避免两边同时出问题难排查。
配置步骤
配置集中在「设置」里，四个字段填完就能用。
图形界面配置 主流程
- 打开「设置」
- API 模式选
OpenAI API Compatible - API Host 填
https://turingapi.space/v1 - 填入 API Key
- 在模型下拉里选或添加模型名
- 保存后新建对话测试
密钥和 Host 都填对但报 401，先检查密钥有没有多余空格，粘贴时常带上。
配置移动端 独立配置
- 在手机上打开同一个客户端
- 重复上面的字段填写
- 如果两端都想用同一个模型，模型名要手动加两次
两端配置互不同步是设计如此，不是 bug。想省事可以先把配置导出一份，再在另一端导入（部分版本支持）。
自定义模型 容易漏
- 在设置里找到「模型」区域
- 点添加，填入站内模型名
- 多个模型逐条添加
gpt-6.1-sol不添加的话，下拉里只有它内置的官方模型名，选中会报模型不存在。
验证是否配置成功
看到这些就说明通了
- 新建对话，发一句话
- 能流式返回内容
- 控制台「用量」页出现记录
ChatBox 有时会在错误提示里只显示「请求失败」，具体原因要看控制台的余额和密钥状态。
报错快速对照
- 401 → 密钥错或带空格
- 404 → Host 多写或少写 /v1
- 403 → 余额不足或该协议未授权
三个错误码对应三类完全不同的原因，先按这个表定位，别急着改配置。
常见问题
ChatBox 的问题基本都能靠错误码定位。
API Host 到底要不要带 /v1？
先按带 /v1 填。如果报 404，去掉再试一次。不同版本的 ChatBox 对这个字段的处理不一样，两种写法都试一遍是最快的判断方式。
电脑上配好了，手机上还要再配一次？
要。配置存在各自设备本地，不会同步。字段和值完全一样，照着填即可。
模型下拉里没有站内的模型？
在设置里手动添加模型名。ChatBox 的下拉是内置清单加你手动添加的项，不会从接口同步。
为什么一直提示请求失败，没有详细信息？
先到控制台看两件事：余额是否为 0、这把密钥是否被禁用。这两个原因占绝大多数，而客户端本身不会把服务端的错误原文完整显示出来。
相关客户端
CCherry Studio
图形界面配置，点「获取模型列表」自动拉取
NNextChat
地址不能带 /v1，它会自己补
LLobeChat
代理地址填 /v1，模型列表要手动加
OOpen WebUI
管理员面板配置，模型自动同步
还没密钥？注册后直接创建一个
邮箱注册即用，控制台自助创建密钥、查看用量与余额。
免费注册 →
接入过程卡住了？到 QQ 群 1128182538 说明「客户端 + 报错码 + 时间点」，比只说"用不了"好排查得多。其他通用问题见 常见问题。