先检查这几项
- 在设置 → 模型提供商中新增自定义提供商，按所用接口选择 OpenAI 兼容类型，填写 apizt Key。
- 核对 API Host 与 API Path 的最终组合，避免 /v1/v1；保存后获取模型，或按平台实际可用 ID 手动添加。
- 回到会话选择刚添加的提供商和模型；只保存设置不会证明当前会话已切换。
正在打开页面…
正在加载内容，请稍候。
常见错误与配置项
连接失败、模型列表为空与会话模型未切换Chatbox API connection failedChatbox API connection failed 的 API 地址怎么填？
按失败位置逐项排查
报错检查与修复步骤
Chatbox API connection failed：地址、模型与对话验证
Chatbox API connection failed 先检查 Provider、API 主机地址和准确模型 ID，区分模型列表与聊天请求。保存脱敏状态码与最终路径；文本回复成功后，再分别验证图片或其他所需能力。
查看报错修复快速判断
- 模型列表失败与聊天失败分开检查；手动添加模型不会修复认证错误。
- 不要因名称含 Gemini 就切换原生 Google 协议。模型经哪个接口提供，就选择对应协议。
Chatbox 报错怎么转成可用配置
不要只看错误码本身。先确认请求是否进入 apizt 后台，再按 API Key、Base URL、模型名、provider 类型排查。 这几个页面分别覆盖认证失败、连接失败、模型不存在、限流和工具配置覆盖问题。