Cherry Studio 接入

Cherry Studio 是一款跨平台（Windows / macOS / Linux）的桌面 AI 客户端，支持多模型、知识库、助手等功能。

配置步骤

1. 打开 Cherry Studio，进入 设置（Settings）→ 模型服务（Model Provider）。

2. 选择一个 OpenAI 类型的服务商，或点 添加 新建一个自定义服务商。

3. 填写：

   字段	值
   API 密钥（API Key）	你的 sk-...
   API 地址（API Host / Base URL）	https://gateway.mindproxy.ai

   TIP

   Cherry Studio 的「API 地址」通常填到域名即可，它会自动补 /v1。如果调用报 404，改成 https://gateway.mindproxy.ai/v1 再试。

4. 在 模型 区域点击 添加 / 管理模型，手动添加你要用的模型 ID，例如 gpt-4o-mini、claude-3-5-sonnet、gemini-1.5-pro。

5. 点击 检查 / 连接测试，通过后即可在对话里选用这些模型。

验证

新建一个对话，选中刚添加的模型，发一句「你好」。能正常回复就接通了。

排障

• 连接测试失败 / 401：检查 Key 是否正确、有没有多余空格，Key 是否被禁用。
• 404：在 API 地址上加上或去掉 /v1。
• 模型列表为空：本平台需要你手动填模型 ID（上面第 4 步），或先用 GET /v1/models 查可用模型。
• 其他见 客户端通用排障 和 错误码与限流。