使用 Cherry Studio 集成 GenStudio API

CherryStudio 是一款支持多个大语言模型（LLM）服务商的桌面客户端，兼容 Windows、Mac 和 Linux 系统。

本教程将指导用户如何在 CherryStudio 中配置并使用算力牛 GenStudio 的 API 服务。

获取 GenStudio API Key

您可以复制已有 API Key 或创建新的 Key。

获取 API 密钥

预置模型 API 服务有 API 频率限制。租户在 GenStudio 的服务等级决定了 API 调用是否计费，以及享受的 API 频率上限。详见 LLM API 计费规则

使用 OpenAI 或 Anthropic 兼容提供商

CherryStudio 可通过自定义提供商接入 GenStudio。请根据模型使用的接口类型分别添加 OpenAI 或 Anthropic 类型的提供商。

添加 OpenAI 类型提供商

OpenAI 类型提供商适用于 GenStudio 的 OpenAI 兼容 Chat Completions、视觉模型、向量嵌入等接口。

1. 在 CherryStudio 官网 选择合适版本并下载。

2. 打开 CherryStudio 设置，进入模型服务，点击左侧提供商列表底部的添加。

3. 在添加提供商弹窗中填写提供商信息：

   • 提供商名称：自定义名称，例如 GenStudio OpenAI。
   • 提供商类型：选择 OpenAI。

4. 选择刚添加的提供商，确认右上角开关为 ON，并填写连接信息：

   • API 密钥：粘贴您获取的 GenStudio API Key。
   • API 地址：填写 https://neogpu.com/maas/v1。该字段需要填写 Base URL，不要追加 /chat/completions；CherryStudio 的预览地址应显示为 https://neogpu.com/maas/v1/chat/completions。

5. 在模型区域点击加号，打开添加模型弹窗。

6. 在添加模型弹窗中填写模型信息：

   • 模型 ID：填写 GenStudio 模型 ID，例如 glm-5.2、glm-5.1。模型 ID 必须与 GenStudio API 服务支持的模型名称保持完全一致。
   • 模型名称：可填写便于识别的显示名称；不填写时，CherryStudio 会根据模型 ID 自动生成。
   • 分组名称：可按需填写，例如 GenStudio；不填写时，CherryStudio 会自动生成分组。

7. 点击添加模型。如需查询模型 ID，可前往 GenStudio 模型广场。

8. 回到对话页面，选择该提供商下的模型，即可通过 OpenAI 兼容接口调用 GenStudio API 服务。

注意

GenStudio OpenAI 兼容 Chat Completions 接口支持 stream_options。在该提供商的API 设置中，可以保持支持 stream_options开启。该选项不适用于 Anthropic Messages 提供商。

添加 Anthropic 类型提供商

Anthropic 类型提供商适用于 GenStudio 的 Anthropic Messages 兼容接口。请先在 GenStudio 模型广场筛选 Claude 兼容模型，再添加对应模型 ID。

1. 打开 CherryStudio 设置，进入模型服务，点击左侧提供商列表底部的添加。

2. 在添加提供商弹窗中填写提供商信息：

   • 提供商名称：自定义名称，例如 GenStudio Anthropic。
   • 提供商类型：选择 Anthropic。

3. 选择刚添加的提供商，确认右上角开关为 ON，并填写连接信息：

   • API 密钥：粘贴您获取的 GenStudio API Key。
   • API 地址：填写 https://neogpu.com/maas。该字段需要填写 Base URL，不要追加 /v1/messages；CherryStudio 会自动补全 API 版本，预览地址应显示为 https://neogpu.com/maas/v1/messages。

4. 在模型区域点击加号，打开添加模型弹窗。

5. 在添加模型弹窗中填写模型信息：

   • 模型 ID：填写在 GenStudio 模型广场中标记为「Claude 兼容」的模型 ID。模型 ID 必须与 GenStudio API 服务支持的模型名称保持完全一致。
   • 模型名称：可填写便于识别的显示名称；不填写时，CherryStudio 会根据模型 ID 自动生成。
   • 分组名称：可按需填写，例如 GenStudio；不填写时，CherryStudio 会自动生成分组。

6. 点击添加模型。

7. 回到对话页面，选择该提供商下的模型，即可通过 Anthropic Messages 兼容接口调用 GenStudio API 服务。

注意

如果同一账号同时使用 OpenAI 兼容模型和 Anthropic Messages 兼容模型，建议分别创建 OpenAI 和 Anthropic 两个提供商，并将模型添加到对应接口类型的提供商下。

注意

如果调用模型时遇到参数、角色、流式输出或响应格式相关问题，请在该提供商标题旁点击齿轮图标（API 设置），按模型能力调整支持 Developer Message、支持 verbosity等选项。支持 enable_thinking对应 Qwen 模型的原生参数，请按目标 Qwen 模型的支持范围配置。不同模型对这些能力的支持范围可能不同，请以模型提供商官网或模型详情页为准；不确定时先关闭相关能力，再逐项开启验证。

支持文件上传

CherryStudio 工具自行实现了文件上传功能，不依赖 API 服务商的文件接口。用户在聊天界面上传文件后，CherryStudio 将直接解析文件内容，并将解析后的内容发送给 API 服务。

当前算力牛 GenStudio 的以下模型可兼容 CherryStudio 的文件上传功能：

• glm-5.1
• kimi-k2.6

注意

如果在 CherryStudio 界面与其他模型对话时，调用文件上传功能将直接报错。清空上下文后可继续对话。

视觉模型

如果需要处理图片，可以使用视觉模型：

• kimi-k2.6

参考资源

• CherryStudio