接入文档
Cherry Studio 接入指南
将熊猫算力接入 Cherry Studio，使用自定义 API 提供商设置。
Cherry Studio 是一款多模型桌面 AI 客户端，支持通过「设置 → 模型服务商」添加自定义 API 提供商。
1 字段对照表
| 字段名称（Cherry Studio 设置页） | 填写内容 |
|---|---|
| API 地址 / Base URL | 平台网关地址 + /v1（Cherry Studio 使用 OpenAI 兼容协议） |
| API 密钥 | 你的 API 密钥（sk-xxxxx） |
| 模型 | 从模型广场复制的模型 ID |
路径差异：带 /v1
Cherry Studio 的「API 地址」字段需要填写带 /v1 的完整地址，例如 https://api.example.com/v1。
如果只填网关地址（不带 /v1），请求会发到错误路径，返回 404。
2 接入步骤
打开 Cherry Studio，进入「设置」→「模型服务商」→「添加服务商」（或「自定义」）。
填写以下信息：
- 服务商名称：随意，如「熊猫算力」
- API 地址：平台网关地址 +
/v1（格式：https://api.example.com/v1） - API 密钥：你的密钥（前往密钥页面创建或复制）
以下组件展示了正确的配置信息（Base URL 已自动填入，密钥为占位符）：
环境变量
在「模型」字段填入从模型广场复制的模型 ID。
保存配置，发一条测试消息，确认能收到回复。
然后前往调用记录 查看调用记录。
3 常见问题
4 下一步
- 快速开始 — 回顾完整上手流程
- Cursor 接入指南 — 另一款 IDE 客户端
- 错误码大全 — 排查常见错误