桌面端接入

本页对应原客户端里的 Cherry Studio 文档页。官网版保留了原有操作路径和字段说明，但把依赖登录态和动态创建 Key 的动作改成静态操作指引。

Cherry Studio

Cherry Studio 支持按 OpenAI / Anthropic / Gemini 兼容方式接入 APIPIG。推荐优先走一键导入，如果客户端没有正确响应深链，再回退到手动配置。

准备信息

  • API Base URL：https://your-domain.com
  • API Key：你在 APIPIG 中生成的 sk-...
  • 提供商类型：anthropic、openai 或 google

注意

Base URL 请直接填写网关根地址，不要追加 /v1。

一键配置思路

Cherry Studio 通过 cherrystudio:// 深度链接导入配置。原客户端里会把以下 JSON 压缩后拼入 data 参数：

{
  "name": "Cherry Studio",
  "type": "anthropic",
  "baseUrl": "https://your-domain.com",
  "apiKey": "sk-new-..."
}

对应协议形式：

cherrystudio://providers/api-keys?v=1&data={Base64Json}

手动配置步骤

  1. 打开 Cherry Studio 设置页。
  2. 新增或选择对应的 OpenAI / Anthropic / Gemini 兼容提供商。
  3. 填写 Base URL 为 https://your-domain.com。
  4. 填写 API Key 为已有密钥。
  5. 名称可自定义，例如 Cherry Studio 或业务线名称。
  6. 保存后发起一次测试请求。

推荐字段

{
  "name": "我的自定义名称",
  "type": "anthropic",
  "baseUrl": "https://your-domain.com",
  "apiKey": "sk-new-..."
}

常见问题

401 / Unauthorized

API Key 错误或已失效，请重新生成并替换。

404 / Not Found

通常是 Base URL 填错。先确认是不是误加了 /v1，或者填成了错误域名。

一键导入未生效

  • 检查是否安装了 Cherry Studio。
  • 确认 cherrystudio:// 协议已注册。
  • 未注册时可以先按本页的手动配置步骤完成接入。

选择哪个提供商类型

  • 接 Claude 兼容能力：优先 anthropic
  • 接 OpenAI / Codex 兼容能力：选择 openai
  • 接 Gemini 兼容能力：选择 google

相关页面