接入 Cherry Studio
开始前，请准备好一把 光迹 API 密钥，并确认账户余额和密钥额度可用。
1. 添加服务商
打开 Cherry Studio 的设置，进入模型服务相关页面，添加一个服务商。名称可以填写「光迹 API」，服务商类型选择 OpenAI 兼容类型。
不同版本的菜单和按钮名称可能略有差异，以你当前安装的版本为准。
2. 填写密钥和地址
| 配置项 | 内容 |
|---|---|
| API 密钥 | 从光迹 API 控制台复制的完整 API Key |
| API 地址 | https://guangjiapi.top，由客户端按对应服务类型补齐接口路径 |
如果当前版本要求完整的 OpenAI Base URL，则填写 https://guangjiapi.top/v1。检查客户端展示的完整地址，聊天补全应为 https://guangjiapi.top/v1/chat/completions。
客户端若提供特殊的路径覆盖语法，只在明确了解其含义时使用；不确定时先恢复普通基础地址，避免路径重复。
3. 获取或添加模型
尝试获取模型列表，添加需要使用的模型。如果列表不能自动获取，可以从光迹 API 模型广场 复制准确的模型 ID 后手动添加。
模型必须在当前密钥分组下可用。不要直接照搬教程截图里的模型名称。
4. 发起聊天
启用并保存服务商配置。返回聊天页面，选择光迹 API 下的目标模型，发送一句简单的话进行测试。
能收到回复后，到光迹 API 使用日志里确认模型和消耗。
常见情况
- 401 / 密钥无效：检查是否复制了完整密钥，是否已禁用或过期。
- 404 / 找不到接口：检查
/v1是否重复，以及接口类型是否正确。 - 模型不存在：检查模型 ID、分组和密钥的模型限制。
- 连接测试通过，实际聊天失败：连接测试与正式对话可能使用不同模型或参数，按实际请求错误排查。
仍有问题时，参考 错误排查。客户端本身的功能说明可查看 Cherry Studio 官方文档。