下载 Cherry Studio
从 Cherry Studio 官方网站或官方 GitHub 下载适合 Windows、macOS 或 Linux 的版本，避免使用来源不明的安装包。
Cherry Studio 官网 → 官方 GitHub →
添加 Api Halo 提供商
- 打开设置中的模型服务或提供商管理。
- 新增 OpenAI Compatible 类型的服务。
- API 地址填写
https://apihalo.cn/v1。 - 填入 Api Halo 控制台创建的独立令牌。
- 手动添加模型广场中的准确模型名。
配置值速查
类型：OpenAI Compatible
Base URL：
API Key：你的 Api Halo 令牌
模型：以模型广场实时数据为准
Base URL：
https://apihalo.cn/v1API Key：你的 Api Halo 令牌
模型：以模型广场实时数据为准
测试连接
保存后新建会话并发送短消息。客户端显示回复且 Api Halo 控制台出现成功日志，才算完整接入成功。
排错
测试连接 404？
客户端若会自动追加 /v1，请改填 https://apihalo.cn，避免重复路径。
列表里没有模型？
可按客户端当前版本的方式手动添加模型 ID；名称必须与模型广场一致。
配套在线工具
按本教程确认安装方式后，带入对应软件生成配置，再执行一次最小连接测试。