跳到主要内容

Cherry Studio

Cherry Studio 可通过 OpenAI compatible Provider 使用 /v1 Base URL。

配置前先确认​

  • 本页只写占位符；实际 Key 从 PopGo API 密钥页复制，模型从模型与价格页复制。
  • 一键配置适合已安装并注册协议的软件；浏览器提示打开外部应用时，需要允许一次。
  • 手动配置时先保存一个最小 Provider，首个请求成功后再启用流式、工具调用或多模型路由。

官方来源与核验​

本页于 2026-07-13 根据官方来源核验 Cherry Studio 1.9.12。 官方来源. 核验范围是 Cherry Studio 的自定义 Provider 配置。

一键配置​

登录 PopGo API 密钥页，在目标 Key 所在行打开操作菜单。公开文档不会生成或展示任何带 Key 的跳转链接。 打开 Chat 子菜单，再选择 Cherry Studio。 导入后确认 Provider 为 OpenAI compatible，并选择当前可用模型。

手动配置​

在 Provider 配置中选择 OpenAI compatible，然后填写下表。

字段值
Provider 类型OpenAI compatible
Base URLhttps://api.popgo.site/v1
API KeyYOUR_API_KEY
ModelYOUR_MODEL

文字版配置流程​

  1. 安装或更新 Cherry Studio 到当前版本，打开后进入“设置 → 模型服务”。
  2. 新建“自定义服务商”，协议选择 OpenAI compatible。不要直接修改软件内置的官方服务商。
  3. Base URL 填 https://api.popgo.site/v1，API Key 填 YOUR_API_KEY，Model 填模型与价格页中的 YOUR_MODEL。
  4. 保存后新建会话，先发送一条短消息；成功后再启用图片、视频、工具调用或较长上下文。
  5. 不同协议或模型族建议分别创建服务商，避免把 Claude、Gemini 和 OpenAI compatible 的地址混用。

常见配置现象​

  • 模型列表为空不一定表示连接失败，很多客户端不自动拉取第三方模型；直接手动填写 YOUR_MODEL。
  • 配置保存后仍请求默认服务时，切换到新 Provider，关闭旧会话并重启客户端。
  • 新能力在旧版客户端中不可见时，先更新客户端，再以当前界面显示的字段为准。

成功判断​

在模型测试或新会话中发送短消息；返回内容且无红色错误即成功。

常见错误和恢复​

  • 连接测试失败时，检查 Base URL 末尾没有重复的 /v1。
  • 出现 401 时，重新粘贴 YOUR_API_KEY 并检查是否带有首尾空格。
  • 出现 404 时，核对 Base URL 层级，避免客户端重复追加 /v1。