外观
Cherry Studio
适合希望用桌面界面进行文本聊天的用户。下面通过自定义服务商接入豆子 API，界面名称可能随 Cherry Studio 版本略有变化。
1. 添加服务商
从 Cherry Studio 官网安装客户端。进入 设置 → 模型服务 → 添加服务商，命名为“豆子 API”，选择 OpenAI 兼容的文本对话端点。
2. 填写连接配置
| 字段 | 填写内容 |
|---|---|
| 名称 | 豆子 API |
| API 地址 | https://api.beanc.cn |
| API 密钥 | 你在豆子 API 创建的密钥 |
| 对话协议 | OpenAI / Chat Completions |
Cherry Studio 的常规 OpenAI 地址会自动补全 /v1/chat/completions，因此这里从根地址填写。保存后核对客户端展示的最终路径，避免出现 /v1/v1。
如果新版本分别显示多个端点，仅配置本次文本对话需要的端点；不要默认改用 Responses。
3. 获取并添加模型
点击“获取模型列表”，把需要的模型加入已启用列表。也可手动添加控制台中的完整模型 ID。随后打开服务商的启用开关。
4. 发起对话
在聊天页选择“豆子 API”下已添加的模型，发送一条简短文本。到使用日志核对本次记录。
常见问题
- 检测成功但列表看不到模型：检查是否添加模型并启用服务商。
- 路径错误：确认最终路径为
/v1/chat/completions。 - 模型不可用：核对实际 ID、密钥分组和模型限制。
- 聊天失败但检测成功：关闭额外能力，先验证普通文本；再检查真实聊天用的模型和协议。
本文只介绍文本聊天。客户端其他功能是否可用，需要单独的模型或服务支持。