先检查这几项
- 服务商选择 OpenAI Compatible 或同等自定义接口。
- Base URL 通常填 https://api.apizt.com/v1，不要填到 /chat/completions。
- 获取模型失败时，可以先手动填写 claude-sonnet-4-6 测试聊天接口。
正在打开页面…
正在加载内容，请稍候。
常见错误与配置项
Base URL invalidCherry Studio Base URL invalidCherry Studio Base URL invalid 要加 /chat/completions 吗？获取模型列表失败 / fetch models failedCherry Studio fetch models failedCherry Studio fetch models failed 能手动添加模型吗？model not foundCherry Studio model not foundCherry Studio 模型显示出来还会 model not found 吗？invalid url /v1/v1Cherry Studio /v1/v1Cherry Studio /v1/v1 应该删哪一个 /v1？
按失败位置逐项排查
报错检查与修复步骤
Cherry Studio Base URL invalid：根地址与 API Path
Cherry Studio Base URL invalid 检查当前 Provider 的 API 根地址及自定义 API Path，确认最终路径只有一个 /v1。官网和文档地址不能作为模型接口；保存后分别验证模型列表与实际对话。
查看报错修复快速判断
- 保存服务商失败
- 测试连接提示 URL 无效
Cherry Studio fetch models failed：模型列表与状态码
Cherry Studio fetch models failed 先查看模型列表请求的状态码，分别排查鉴权、根地址、代理和列表接口。手动添加准确模型只能替代列表发现步骤；仍需单独验证真实聊天，不能修复无效 Key。
查看报错修复快速判断
- 点获取模型列表后提示失败或显示空列表
- 手动添加模型后可以聊天，但自动获取失败
Cherry Studio model not found：准确 ID 与 Provider
Cherry Studio model not found 核对所选 Provider、模型 ID 与当前令牌分组授权。手工名称或其他平台别名不能当作真实 ID；保存模型后新开对话，检查最终请求的 model 字段与返回。
查看报错修复快速判断
- 测试连接成功但聊天失败
- 错误显示 model not found
Cherry Studio /v1/v1：重复路径与 invalid url 修复
Cherry Studio /v1/v1 说明 API 根地址与客户端自动附加路径可能重复。检查 Base URL、API Path 和当前版本拼接规则，只保留一次 /v1；修改后看最终聊天请求地址，而不是仅测试域名能否打开。
查看报错修复快速判断
- 请求地址包含 /v1/v1
- 404 或 invalid url
Cherry Studio 报错怎么转成可用配置
不要只看错误码本身。先确认请求是否进入 apizt 后台，再按 API Key、Base URL、模型名、provider 类型排查。 这几个页面分别覆盖认证失败、连接失败、模型不存在、限流和工具配置覆盖问题。