Cherry Studio
在桌面客户端 Cherry Studio 中添加 OpenAI 兼容服务商并接入 AnyStarX。
Cherry Studio 是一款跨平台的 AI 桌面客户端，支持多模型会话管理与自定义服务商配置。推荐使用标准 OpenAI 兼容协议完成接入。
1. 新建服务商
- 启动 Cherry Studio，依次进入 设置 → 模型服务。
- 点击 添加自定义服务商。
- 服务商类型选择 OpenAI（或 OpenAI Compatible）。
2. 配置接口参数
| 配置项 | 填写内容 |
|---|---|
| 服务商名称 | AnyStarX（自定义标识） |
| API Key | 在管理控制台创建的有效密钥 |
| API 地址 | https://console.anystarx.com |
| 模型 ID | 控制台模型列表中复制的完整标识符 |
API 地址填写规则
Cherry Studio 会在发起对话时自动拼接 /v1/chat/completions。在服务商的 API 地址栏中通常仅需填入根地址 https://console.anystarx.com，避免重复拼接 /v1 导致 404 错误。
若上游端点使用非标准路由，可填入完整 URL 并在末尾追加 # 字符，告知客户端禁止自动追加路径。
3. 声明模型并测试
- 在新建的服务商详情页中，点击添加模型，填入控制台中的完整模型 ID。
- 返回聊天界面，在模型选择菜单中切换至刚添加的模型。
- 发送测试消息，验证模型是否能正常返回内容。
4. 配置 Anthropic 协议服务商
如果需要使用 Claude 协议特有的参数与格式，可以在模型服务中另行添加一个 Anthropic 类型的服务商：
| 配置项 | 填写内容 |
|---|---|
| API Key | 使用相同的有效 API Key |
| API 地址 | https://console.anystarx.com |
具体的路由拼接规范可查阅 Cherry Studio 官方服务商文档。
常见问题排查
- 提示 404 Not Found：通常是 API 地址中重复输入了
/v1或包含了完整的接口后缀，修改为根域名端点后重新测试。 - 提示 401 Unauthorized：核实 API Key 是否完整，并检查首尾是否含有复制引入的空格。
- 提示模型不可用：确认已在当前服务商条目下明确声明了该模型，且填入的模型 ID 与控制台列表完全吻合。