PilotAIHubPilotAIHub
免费创建账号

接入 Cherry Studio

将 Cherry Studio 桌面客户端接入 PilotAIHub，统一管理多模型对话。

简介

Cherry Studio 是一款支持多服务商的桌面 AI 对话客户端，原生支持「OpenAI 兼容」自定义服务商。将其指向 PilotAIHub 网关后，可在统一界面中切换 PilotAIHub 托管的全部模型，并通过虚拟 Key 进行治理与审计。

前置条件

已注册 PilotAIHub 账号并创建虚拟 Key；已安装 Cherry Studio。

安装 Cherry Studio

访问 cherry-ai.com 下载安装，支持 macOS / Windows / Linux。

配置 base_url

将 Cherry Studio 的 OpenAI 兼容接口地址指向 PilotAIHub 网关：

配置位置

打开 Cherry Studio → 设置 → 模型服务 → 添加服务商 → 选择「OpenAI 兼容」→ 填入下方的 API 域名（base_url）与 API Key，然后在该服务商下添加要使用的模型 model_code。
base_url
https://api.pilotaihub.com

配置 API Key

在 PilotAIHub 控制台创建虚拟 API Key（以 pk- 开头），填入 Cherry Studio 的 API Key / Secret 字段：

api_key
sk-p-xxxxxxxxxxxxxxxx

Key 安全

API Key 是账户凭证，请勿提交到代码仓库或公开分享。Cherry Studio 的配置仅保存在本地，不会上传 PilotAIHub 之外。

选择模型

在 Cherry Studio 的模型选择处填写 PilotAIHub 支持的 model_code，例如 gpt-4o。完整模型列表见控制台「模型」页或模型市场。

验证调用

配置完成后，用以下请求验证连通性。成功时应返回模型回复：

curl 验证
curl https://api.pilotaihub.com/chat/completions \
  -H "Authorization: Bearer sk-p-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍你自己"}
    ]
  }'

期望响应

HTTP 200 + 一条 assistant 角色的回复。若返回 401 请检查 Key 是否正确；若返回 429 请降低请求频率或联系管理员提升限额。

进阶用法

  • 可添加多个服务商对应多个 PilotAIHub Key，分别用于不同项目或团队。
  • 对话窗口中可随时切换模型，无需重新配置 Key。
  • Cherry Studio 的助手（Agent）模板可绑定指定模型，按场景选用。

常见问题

模型需手动添加

Cherry Studio 不会自动拉取 PilotAIHub 的模型列表，需在服务商配置中手动添加 model_code（如 gpt-4o），与控制台「模型」页一致。

401/429 排查见 Cursor 接入。