在 Cherry Studio 中使用 OpenVeer

详细指导如何在 Cherry Studio 桌面客户端中配置和使用 OpenVeer API 服务，本指南将帮助您在 Cherry Studio 中配置 OpenVeer API，以便使用丰富的 AI 模型资源。

准备工作

在开始之前，请确保：

1. 已安装 Cherry Studio\
   从 Cherry Studio 官网 下载并安装适合您操作系统的版本

2. 已获取 OpenVeer API 密钥\
   登录 OpenVeer 控制台 获取您的 API 密钥（以 sk- 开头）

第一步：打开 Cherry Studio 设置

启动 Cherry Studio 后，进入设置页面：

1. 点击右上角的 ⚙️ 设置 图标（齿轮图标）
2. 或使用快捷键：
   * Windows/Linux: Ctrl +
   * macOS: Cmd +

Cherry Studio 主界面，点击右上角齿轮图标进入设置

第二步：添加 OpenVeer 模型平台

2.1 进入模型服务管理

在设置页面中：

1. 在左侧菜单找到 模型服务 选项
2. 点击进入模型服务管理页面

在设置页面左侧菜单找到"模型服务"选项

2.2 添加 OpenVeer 提供商

1. 在模型服务页面底部，点击 "+ 添加" 按钮

点击"+ 添加"后会弹出添加提供商对话框

2. 在弹出的 "添加提供商" 对话框中填写：
   * 提供商名称：OpenVeer（可自定义）
   * 提供商类型：选择 OpenAI

3. 点击 "确定" 按钮

2.3 配置 OpenVeer API 信息

添加提供商后，在右侧配置区域填写 API 信息：

填写 API 密钥和 API 地址，确保 OpenVeer 提供商状态为 ON（绿色开关）

第三步：添加和管理模型

3.1 打开模型管理

在 OpenVeer 提供商配置完成后：

1. 确保 OpenVeer 提供商右上角的开关为 ON（绿色）
2. 在右侧配置区域，找到 "模型" 部分
3. 点击 "管理" 按钮打开模型选择窗口

点击"管理"按钮打开 OpenVeer 模型选择窗口

3.2 添加需要的模型

在弹出的模型选择窗口中：

1. 可以使用搜索框查找特定模型
2. 使用顶部的分类标签筛选：全部、推理、视觉、联网、免费、嵌入、重排、工具
3. 找到您想使用的模型，点击右侧的 + 按钮添加：
   * gpt-4o / chatgpt-4o - OpenAI GPT-4o 模型
   * gpt-4o-mini - 更快速且经济的版本
   * claude-3 系列 - Claude 3 模型（含多个变体）
   * claude_code_sonnet-4 - Claude Code Sonnet 4
   * claude_code_haiku-4 - Claude Code Haiku 4
   * gemini-2.0-flash-exp - Google Gemini 2.0 Flash

已添加的模型会显示在右侧，可以展开查看具体变体

4. 添加完所需模型后，关闭模型选择窗口即可

第四步：开始对话

配置完成后，您就可以开始使用了：

1. 回到主界面，点击顶部的 "+" 号或选择现有对话
2. 在对话页面顶部，点击模型选择器
3. 选择 OpenVeer 提供商下的模型
4. 开始与 AI 对话！

新建对话并选择 OpenVeer 服务商和模型

Cherry Studio 对话界面示例

常见问题

Q1: 无法连接到 OpenVeer 服务？

解决方案：

1. 检查 Base URL：
   * 确保 Base URL 是 https://api.openveer.com
   * 不要添加 /v1 后缀

2. 验证 API Key：
   * 确认 API Key 正确且以 sk- 开头
   * 在 OpenVeer 控制台 检查密钥是否有效

3. 检查网络连接：
   * 确保能够访问 https://api.openveer.com
   * 如果在国内，可能需要配置代理

Q2: 模型列表为空或无法刷新？

解决方案：

1. 手动添加模型：
   * 如果自动刷新失败，可以手动添加常用模型
   * 在模型管理中，手动输入模型名称（如 gpt-4o）

2. 检查 API 权限：
   * 确认您的 API Key 有访问模型列表的权限
   * 联系 OpenVeer 支持检查账户状态

Q3: 对话时出现错误提示？

常见错误及解决方案：

Q4: 如何查看 API 使用情况和费用？

登录 OpenVeer 控制台 查看：

• 📊 API 调用统计
• 💰 费用明细
• 📈 使用趋势图表

功能特性

使用 Cherry Studio + OpenVeer，您可以：

• 💬 多模型对话 - 在同一界面使用不同的 AI 模型
• 🖼️ 图像理解 - 支持图像输入的多模态对话
• 📝 上下文管理 - 智能管理对话历史和上下文
• 🎨 自定义提示词 - 创建和管理提示词模板
• 📊 对话导出 - 导出对话记录为 Markdown 等格式
• 🔄 模型对比 - 同时使用多个模型并对比输出

支持与帮助

如果您在使用过程中遇到任何问题：

• 📚 OpenVeer 文档中心
• 💬 Discord 社区
• 🐦 Twitter @OpenVeer_