Cherry Studio能够借助「自定义服务商」功能接入所有兼容OpenAI格式的第三方API平台。下面是官方标准的配置流程涵盖全平台通用步骤、关键参数说明以及常见问题排查权威性高可直接复用。前期准备工作从官网 https://cherry-ai.com 下载并安装最新版的Cherry Studio支持Windows、macOS、Linux系统。访问诗云官网 https://shiyunapi.com/先注册账号然后登录接着创建API密钥并妥善保存。确认诗云API的基础地址为https://shiyunapi.com该地址兼容OpenAI格式无需额外后缀。核心配置步骤通用流程第一步进入模型服务设置启动Cherry Studio后点击左侧导航栏的设置齿轮图标然后切换到模型服务选项卡。第二步添加自定义服务商在模型服务页面的底部点击 添加此时会弹出「添加提供商」窗口。第三步填写基础配置关键环节以诗云API为例按以下要求填写参数提供商名称可以自定义比如「诗云API」方便识别。提供商类型必须选择OpenAI所有兼容OpenAI格式的API都应选此项。API密钥粘贴从诗云平台获取的API密钥。API地址BaseUrl填写https://shiyunapi.com这是诗云的官方地址。其他参数默认留空无需修改。第四步验证配置有效性填写完毕后点击右侧的检查按钮如果显示「连接成功」则说明配置有效。第五步添加可用模型必要操作验证成功后在当前服务商配置页点击 ** 添加 **输入诗云支持的模型ID例如gpt-3.5-turbo、claude-3-opus、deepseek-r1等然后点击确定保存。诗云支持所有国内外主流模型完整的模型列表可在诗云官网查看。可以添加多个模型并根据需要启用或禁用。第六步启用服务商将当前自定义服务商右上角的开关打开开关变为绿色至此配置完成。关键参数说明避坑指南提供商类型仅支持OpenAI、Gemini、Anthropic、Azure OpenAI这几种类型。像诗云这类第三方聚合API必须选择OpenAI否则无法连接。API地址BaseUrl格式为https://域名无需添加 /v1 后缀Cherry Studio会自动拼接。诗云的固定地址是https://shiyunapi.com。模型ID必须填写 ** exact 模型ID**非中文名例如qwen-max、llama3-70b。错误示例有「GPT-3.5」「通义千问」这类名称无法被识别。诗云API专属配置示例完整参数项填写内容说明提供商名称诗云API自定义便于区分提供商类型OpenAI固定选项API密钥sk-xxxxxxxxxxxx从诗云官网获取API地址https://shiyunapi.com官方BaseUrl无后缀模型IDgpt-3.5-turbo、claude-3-sonnet、deepseek-r1诗云支持的任意模型常见问题排查检查失败 / 连接超时核对API地址诗云的地址必须是https://shiyunapi.com不能有多余字符。核对API密钥要确保复制完整没有空格且未过期。网络方面可以关闭代理 / 加速器或者配置Cherry Studio的内置代理。模型加载失败 / 不存在可能是模型ID错误需要复制诗云官网的 ** exact ID**。要手动添加模型系统不会自动同步。确认诗云账号是否已开通对应模型的权限。配置后不显示模型可能是开关未打开需要启用服务商。可能是模型未添加要在服务商页手动添加。可以尝试重启Cherry Studio刷新配置。使用方法配置完成后返回对话界面点击顶部的模型选择框选择「诗云 API」下的任意模型就可以正常进行对话和生成内容了。
