Chatbox 配置自定义 AI API：从填地址到测试模型

配置前的准备

从 Chatbox 官方渠道安装客户端，并准备服务商文档中的 Base URL、API Key 与 Model ID。不要使用网页首页地址代替 API 地址，也不要把模型的中文名称当作 Model ID。

为 Chatbox 单独创建一把密钥，设置合理额度。这样日后更换设备或发现异常时，可以只撤销这一把。

添加自定义服务

打开设置中的模型提供方或 API 配置。服务商文档如果注明兼容 OpenAI 格式，选择对应的自定义或兼容选项。把三个信息逐项粘贴：

1. API Key：确认没有多余空格。
2. API Host 或 Base URL：按文档保留所需版本路径。
3. Model ID：从模型列表复制，大小写与符号保持一致。

界面名称会随版本变化，但核心字段不会改变。保存后，在新对话顶部选择刚添加的模型。

完成两次测试

第一次只发送“请回复：测试成功”，用于验证连接。第二次发送一小段文字，要求按三点总结，用于验证中文、输出长度与账单记录。随后回到服务商控制台，核对模型名称、Token 和扣费。

常见问题

出现 401 时重新创建并粘贴密钥；出现 404 时核对 Base URL 和 Model ID；模型列表为空不一定代表服务不可用，可以按服务商文档手动添加；一直转圈则先关闭代理扩展、联网和工具调用，用纯文本重试。

推荐的日常设置

默认输出长度不要设得过高；完成一个主题后新建对话，避免历史上下文不断增加；重要对话定期导出，但不要把带密钥的配置文件发送给他人。

配置成功的判断标准不只是“能收到回复”，还包括控制台账单对应、模型名称正确、连续几次请求稳定。