在 Cherry Studio 中使用 OneAster

​

准备工作

在开始之前，请确保：

1. 已安装 Cherry Studio
   从 Cherry Studio 官网 下载并安装适合您操作系统的版本
2. 已获取 OneAster API 密钥
   登录 OneAster 控制台 获取您的 API 密钥（以 sk- 开头）

​

第一步：打开 Cherry Studio 设置

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

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

​

第二步：添加 OneAster 模型平台

​

2.1 进入模型服务管理

在设置页面中：

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

​

2.2 添加 OneAster 提供商

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

2. 在弹出的 “添加提供商” 对话框中填写：
   • 提供商名称：oneaster（可自定义）
   • 提供商类型：选择 OpenAI
3. 点击 “确定” 按钮

​

2.3 配置 OneAster API 信息

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

​

第三步：添加和管理模型

​

3.1 打开模型管理

在 OneAster 提供商配置完成后：

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

​

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. 选择 OneAster 提供商下的模型
4. 开始与 AI 对话！

​

常见问题

​

Q1: 无法连接到 OneAster 服务？

解决方案：

1. 检查 Base URL：
   • 确保 Base URL 是 https://api.oneaster.ai
   • 不要添加 /v1 后缀
2. 验证 API Key：
   • 确认 API Key 正确且以 sk- 开头
   • 在 OneAster 控制台 检查密钥是否有效
3. 检查网络连接：
   • 确保能够访问 https://api.oneaster.ai
   • 如果在国内，可能需要配置代理

​

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

解决方案：

1. 手动添加模型：
   • 如果自动刷新失败，可以手动添加常用模型
   • 在模型管理中，手动输入模型名称（如 gpt-4o）
2. 检查 API 权限：
   • 确认您的 API Key 有访问模型列表的权限
   • 联系 OneAster 支持检查账户状态

​

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

常见错误及解决方案：

​

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

登录 OneAster 控制台 查看：

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

​

功能特性

使用 Cherry Studio + OneAster，您可以：

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

​

支持与帮助

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

• 📚 OneAster 文档中心
• 💬 Discord 社区
• 🐦 Twitter @oneaster_
• 📧 技术支持：[email protected]

---