Cherry Studio Guide
Cherry Studio 如何配置 ZZSwitch API
Cherry Studio 适合把多个模型服务商集中管理。接入 ZZSwitch 时，按 OpenAI 兼容服务商填写 API 地址、API Key，并在模型管理中添加可用模型。
API 地址
https://api.zzswitch.com/v1
使用 ZZSwitch Token 作为 API Key。模型从控制台或 Cherry Studio 获取列表后添加。
配置步骤
在 Cherry Studio 的模型服务设置中新增或编辑 OpenAI 兼容服务商。API 地址填写 https://api.zzswitch.com/v1，API Key 填写 ZZSwitch 令牌，然后打开服务商开关。
API 地址要不要带完整路径？
Cherry Studio 文档说明通常只需要填写 API 根地址部分，客户端会自动拼接后续路径。ZZSwitch 的 OpenAI 兼容入口建议填写 https://api.zzswitch.com/v1，不要填写到 `/chat/completions` 这种完整请求路径。
多 Key 怎么处理？
如果你有多个 ZZSwitch Token，可以按 Cherry Studio 的多 Key 规则用英文逗号分隔。但更建议先用一个 Token 验证清楚，再按实际需要扩展。
模型怎么添加？
在模型管理里获取或手动添加模型。可用模型、倍率和价格以 ZZSwitch 控制台为准，不建议在官网照抄固定模型列表。
验证方式
填写完成后先点击检查或测试按钮，确认连接成功。再用短文本生成测试消耗，确认余额扣费符合预期。