Agnes 模型的 Cherry Studio 集成指南
1. 概述
本文档说明如何在 Cherry Studio 中配置 Agnes 自定义模型。设置完成后，Cherry Studio 可以调用 Agnes 文本模型进行对话。Agnes 图像和视频模型也可以通过 Skills 或绑定到代理来使用。2. 前置条件
在开始之前，请确保你已具备：- 已安装 Cherry Studio。
- 一个 Agnes AI API Key。
- 能够访问 Agnes AI API 网关的网络环境。
- 你想要使用的模型名称。
3. 获取 Agnes API Key
访问 Agnes AI 平台： https://platform.agnes-ai.com/ 登录后，进入 API Key 页面，创建一个 API Key 并复制。4. 添加提供商
打开 Cherry Studio，进入 API 提供商或模型设置页面。 点击：5. 选择提供商类型
对于提供商类型，选择：6. 输入提供商名称
你可以将提供商名称设置为：7. 输入 API Key
在 API Key 字段中，输入从 Agnes AI 平台获取的 API Key。 示例：YOUR_API_KEY
在大多数情况下，你不需要手动添加 Bearer 前缀。
8. 输入 API Base URL
将 API Base URL 设置为：https://apihub.agnes-ai.com/v1
通常，你不需要输入完整的 /chat/completions 端点。
推荐格式：
https://apihub.agnes-ai.com/v1
不推荐：
https://apihub.agnes-ai.com/v1/chat/completions
只有当 Cherry Studio 明确要求时，才使用完整的端点 URL。
9. 获取模型列表
点击获取模型列表。 如果 API Key 和 API Base URL 正确，Cherry Studio 应该能够检索到可用的 Agnes 模型。 选择文本模型：agnes-2.0-flash
10. 保存配置
确认提供商名称、API Key、API Base URL 和模型名称正确后，点击保存。 保存成功后，模型列表中将出现 Agnes 模型。11. 验证文本模型
在 Cherry Studio 中创建一个新聊天，选择：agnes-2.0-flash
发送一条测试消息：
12. 使用图像和视频模型
在 Cherry Studio 中，图像和视频模型建议通过创建 Skills 并绑定到代理来使用。 你可以创建一个 Agnes Image Skill 来调用 Agnes 图像模型。 示例 Skill 名称：13. 故障排查
1. 无法获取模型列表
检查 API Base URL 是否正确：https://apihub.agnes-ai.com/v1
同时确认 API Key 是有效的。
2. 认证失败
确保 API Key 输入正确，并且账户有足够的余额或积分。3. 模型未找到
确认模型名称正确。 推荐模型：agnes-2.0-flash