使用 Cherry Studio 集成 GenStudio API
CherryStudio 是一款支持多个大语言模型(LLM)服务商的桌面客户端,兼容 Windows、Mac 和 Linux 系统。
本教程将指导用户如何在 CherryStudio 中配置并使用算力牛 GenStudio 的 API 服务。
获取 GenStudio API Key
您可以复制已有 API Key 或创建新的 Key。
预置模型 API 服务有 API 频率限制。租户在 GenStudio 的服务等级决定了 API 调用是否计费,以及享受的 API 频率上限。详见 LLM API 计费规则
配置 GenStudio API 服务
CherryStudio 可通过自定义提供商接入 GenStudio。请根据模型使用的接口类型分别添加 OpenAI 或 Anthropic 类型的提供商。
添加 OpenAI 类型提供商
OpenAI 类型提供商适用于 GenStudio 的 OpenAI 兼容 Chat Completions、视觉模型、向量嵌入等接口。
在 CherryStudio 官网 选择合适版本并下载。
打开 CherryStudio 设置,进入模型服务,点击左侧提供商列表底部的添加。
在添加提供商弹窗中填写提供商信息:
- 提供商名称:自定义名称,例如
GenStudio OpenAI。 - 提供商类型:选择 OpenAI。
- 提供商名称:自定义名称,例如
选择刚添加的提供商,确认右上角开关为 ON,并填写连接信息:
- API 密钥:粘贴您获取的 GenStudio API Key。
- API 地址:填写
https://neogpu.com/maas/v1。该字段需要填写 Base URL,不要追加/chat/completions;CherryStudio 的预览地址应显示为https://neogpu.com/maas/v1/chat/completions。
在模型区域点击加号,打开添加模型弹窗。
在添加模型弹窗中填写模型信息:
- 模型 ID:填写 GenStudio 模型 ID,例如
glm-5.2、glm-5.1。模型 ID 必须与 GenStudio API 服务支持的模型名称保持完全一致。 - 模型名称:可填写便于识别的显示名称;不填写时,CherryStudio 会根据模型 ID 自动生成。
- 分组名称:可按需填写,例如
GenStudio;不填写时,CherryStudio 会自动生成分组。
- 模型 ID:填写 GenStudio 模型 ID,例如
点击添加模型。如需查询模型 ID,可前往 GenStudio 模型广场。
回到对话页面,选择该提供商下的模型,即可通过 OpenAI 兼容接口调用 GenStudio API 服务。
添加 Anthropic 类型提供商
Anthropic 类型提供商适用于 GenStudio 的 Anthropic Messages 兼容接口。请先在 GenStudio 模型广场筛选 Claude 兼容模型,再添加对应模型 ID。
打开 CherryStudio 设置,进入模型服务,点击左侧提供商列表底部的添加。
在添加提供商弹窗中填写提供商信息:
- 提供商名称:自定义名称,例如
GenStudio Anthropic。 - 提供商类型:选择 Anthropic。
- 提供商名称:自定义名称,例如
选择刚添加的提供商,确认右上角开关为 ON,并填写连接信息:
- API 密钥:粘贴您获取的 GenStudio API Key。
- API 地址:填写
https://neogpu.com/maas。该字段需要填写 Base URL,不要追加/v1/messages;CherryStudio 会自动补全 API 版本,预览地址应显示为https://neogpu.com/maas/v1/messages。
在模型区域点击加号,打开添加模型弹窗。
在添加模型弹窗中填写模型信息:
- 模型 ID:填写支持 Anthropic Messages 兼容接口的 GenStudio 模型 ID,例如
glm-4.6、glm-4.5、minimax-m2.7。模型 ID 必须与 GenStudio API 服务支持的模型名称保持完全一致。 - 模型名称:可填写便于识别的显示名称;不填写时,CherryStudio 会根据模型 ID 自动生成。
- 分组名称:可按需填写,例如
GenStudio;不填写时,CherryStudio 会自动生成分组。
- 模型 ID:填写支持 Anthropic Messages 兼容接口的 GenStudio 模型 ID,例如
点击添加模型。
回到对话页面,选择该提供商下的模型,即可通过 Anthropic Messages 兼容接口调用 GenStudio API 服务。
信息
如果同一账号同时使用 OpenAI 兼容模型和 Anthropic Messages 兼容模型,建议分别创建 OpenAI 和 Anthropic 两个提供商,并将模型添加到对应接口类型的提供商下。
信息
如果调用模型时遇到参数、角色、流式输出或响应格式相关问题,请在该提供商标题旁点击齿轮图标(API 设置),按模型能力调整支持 Developer Message、支持 stream_options、支持 verbosity、支持 enable_thinking等选项。不同模型对这些能力的支持范围可能不同,请以模型提供商官网或模型详情页为准;不确定时先关闭相关能力,再逐项开启验证。
支持文件上传
CherryStudio 工具自行实现了文件上传功能,不依赖 API 服务商的文件接口。用户在聊天界面上传文件后,CherryStudio 将直接解析文件内容,并将解析后的内容发送给 API 服务。
当前算力牛 GenStudio 的以下模型可兼容 CherryStudio 的文件上传功能:
deepseek-r1deepseek-v3glm-5.1kimi-k2.6
信息
如果在 CherryStudio 界面与其他模型对话时,调用文件上传功能将直接报错。清空上下文后可继续对话。
视觉模型
如果需要处理图片,可以使用视觉模型:
glm-4.6v