客户端接入 · Cherry Studio

Cherry Studio 接入 HardysAPI:三步配好

Cherry Studio 自带的服务商列表里没有中转站,需要自己加一个「OpenAI 兼容」提供商。核心只有三个字段:API 地址、密钥、模型名。

先准备两样东西:在 控制台 创建 API 密钥(复制 sk- 开头的完整字符串), 以及要用的模型名(从 模型价格 里挑,名字要一字不差)。

配置步骤

  1. 打开 设置 → 模型服务,在列表底部点「添加」,类型选 OpenAI(即 OpenAI 兼容);
  2. 名称随便写(例如 HardysAPI),API 地址填 https://hardysapi.com/v1;
  3. API 密钥粘贴控制台里的 sk-...;
  4. 该提供商下的「模型」一栏点「添加」,手动输入模型名,例如 claude-sonnet-4-5、gpt-5.5;
  5. 右上角把该提供商打开(开关变蓝),回到聊天页在模型选择器里选中它。

字段对照

Cherry Studio 字段填什么
API 地址https://hardysapi.com/v1
API 密钥sk- 开头的完整密钥
模型 ID与 模型价格 里完全一致的模型名

如果地址填 https://hardysapi.com/v1 后请求 404,把结尾的 /v1 去掉再试一次—— 部分版本会自动补 /v1,两种写法只能对一种。

三个高频坑

  • 模型名手打错:Cherry Studio 的模型列表是本地维护的,不在列表里就不会发请求,报「模型不存在」多半是名字少了个后缀(如 -20251101)。
  • 密钥属于别的分组:密钥只能调用它所在分组里的模型。换模型前先在 价格页 确认该分组支持。
  • 开了「知识库 / 联网」等插件:插件会额外发请求,失败时容易被误判成 API 不通,先关掉插件只发一条纯文本消息。

验证是不是 API 的问题

最小验证bash
curl https://hardysapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"hi"}]}'

这条命令能返回内容,说明密钥、余额、模型都正常,问题在客户端填写的字段上; 它也报错,就按 报错排查 里的错误码对照处理。

常见问题

Cherry Studio 的 API 地址要带 /v1 吗?

推荐填 https://hardysapi.com/v1。若报 404,改成 https://hardysapi.com 重试,因为不同版本对 /v1 的补齐行为不同。

Cherry Studio 支持 Claude 模型吗?

支持。用同一个 OpenAI 兼容地址即可调用 Claude 系列,不需要单独配置 Anthropic 格式;模型名填 claude-sonnet-4-5 这类完整名称。

为什么模型选择器里看不到新加的模型?

添加模型后需要在该提供商下点一下「刷新」或重启客户端,并且要确保提供商开关处于开启状态。