> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elkapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 在 Cherry Studio 中使用 ElkAPI
> 详细指导如何在 Cherry Studio 桌面客户端中配置和使用 ElkAPI API 服务，本指南将帮助您在 Cherry Studio 中配置 ElkAPI API，以便使用丰富的 AI 模型资源。
## 准备工作
在开始之前，请确保：
1. **已安装 Cherry Studio**\
从 [Cherry Studio 官网](https://cherry-ai.com/) 下载并安装适合您操作系统的版本
2. **已获取 ElkAPI API 密钥**\
登录 [ElkAPI 控制台](https://api.elkapi.com/keys) 获取您的 API 密钥（以 `sk-` 开头）
**提示：** 如果还没有 ElkAPI 账户，请先在 [ElkAPI](https://api.elkapi.com) 注册并获取 API 密钥。
## 第一步：打开 Cherry Studio 设置
启动 Cherry Studio 后，进入设置页面：
1. 点击右上角的 **⚙️ 设置** 图标（齿轮图标）
2. 或使用快捷键：
* Windows/Linux: `Ctrl + `
* macOS: `Cmd + `
*Cherry Studio 主界面，点击右上角齿轮图标进入设置*
## 第二步：添加 ElkAPI 模型平台
### 2.1 进入模型服务管理
在设置页面中：
1. 在左侧菜单找到 **模型服务** 选项
2. 点击进入模型服务管理页面
*在设置页面左侧菜单找到"模型服务"选项*
### 2.2 添加 ElkAPI 提供商
1. 在模型服务页面底部，点击 **"+ 添加"** 按钮
*点击"+ 添加"后会弹出添加提供商对话框*
2. 在弹出的 **"添加提供商"** 对话框中填写：
* **提供商名称**：`ElkAPI`（可自定义）
* **提供商类型**：选择 `OpenAI`
3. 点击 **"确定"** 按钮
### 2.3 配置 ElkAPI API 信息
添加提供商后，在右侧配置区域填写 API 信息：
| 配置项 | 填写内容 |
| ---------- | ----------------------------------- |
| **API 密钥** | 您的 ElkAPI API 密钥（`sk-xxxxxxxxxxxx`） |
| **API 地址** | `https://api.elkapi.com` |
**重要提示：** - API 地址必须是 `https://api.elkapi.com`（不要包含 `/v1` 或其他路径） - API 密钥必须是从 ElkAPI 控制台获取的以 `sk-` 开头的密钥 - 填写完成后可以点击 **"检测"**
按钮测试连接
*填写 API 密钥和 API 地址，确保 ElkAPI 提供商状态为 ON（绿色开关）*
## 第三步：添加和管理模型
### 3.1 打开模型管理
在 ElkAPI 提供商配置完成后：
1. 确保 ElkAPI 提供商右上角的开关为 **ON**（绿色）
2. 在右侧配置区域，找到 **"模型"** 部分
3. 点击 **"管理"** 按钮打开模型选择窗口
*点击"管理"按钮打开 ElkAPI 模型选择窗口*
### 3.2 添加需要的模型
在弹出的模型选择窗口中：
1. 可以使用搜索框查找特定模型
2. 使用顶部的分类标签筛选：**全部**、**推理**、**视觉**、**联网**、**免费**、**嵌入**、**重排**、**工具**
3. 找到您想使用的模型，点击右侧的 **+** 按钮添加：
* `gpt-5.5` / `gpt-5.5-pro` - OpenAI GPT-5.5 模型
* `gpt-5.4-mini` - 更快速且经济的版本
* `claude-sonnet-4-6` 系列 - Claude Sonnet 4.6 模型（含多个变体）
* `claude-sonnet-4-6-thinking` - Claude Sonnet 4.6 Thinking
* `claude-sonnet-4-6` - Claude Sonnet 4.6
* `gemini-3.1-flash-lite-preview` - Google Gemini 3.1 Flash Lite
*已添加的模型会显示在右侧，可以展开查看具体变体*
4. 添加完所需模型后，关闭模型选择窗口即可
**推荐模型：** - 💰 **高性价比：** `gpt-5.4-mini`、`claude-sonnet-4-6` - 🚀 **高性能：** `gpt-5.5` / `gpt-5.5-pro`、`claude-sonnet-4-6-thinking` - 🎨 **多模态：** `claude-sonnet-4-6`
系列、`gemini-3.1-flash-lite-preview`
## 第四步：开始对话
配置完成后，您就可以开始使用了：
1. 回到主界面，点击顶部的 **"+"** 号或选择现有对话
2. 在对话页面顶部，点击模型选择器
3. 选择 **ElkAPI** 提供商下的模型
4. 开始与 AI 对话！
*新建对话并选择 ElkAPI 服务商和模型*
*Cherry Studio 对话界面示例*
## 常见问题
### Q1: 无法连接到 ElkAPI 服务？
**解决方案：**
1. **检查 Base URL**：
* 确保 Base URL 是 `https://api.elkapi.com`
* 不要添加 `/v1` 后缀
2. **验证 API Key**：
* 确认 API Key 正确且以 `sk-` 开头
* 在 [ElkAPI 控制台](https://api.elkapi.com/keys) 检查密钥是否有效
3. **检查网络连接**：
* 确保能够访问 `https://api.elkapi.com`
* 如果在国内，可能需要配置代理
### Q2: 模型列表为空或无法刷新？
**解决方案：**
1. **手动添加模型**：
* 如果自动刷新失败，可以手动添加常用模型
* 在模型管理中，手动输入模型名称（如 `gpt-5.5`）
2. **检查 API 权限**：
* 确认您的 API Key 有访问模型列表的权限
* 联系 ElkAPI 支持检查账户状态
### Q3: 对话时出现错误提示？
**常见错误及解决方案：**
| 错误信息 | 原因 | 解决方法 |
| --------------------------- | ------------- | ------------------ |
| `401 Unauthorized` | API Key 无效或过期 | 重新获取 API Key 并更新配置 |
| `429 Too Many Requests` | 请求频率超限 | 稍等片刻后重试 |
| `500 Internal Server Error` | 服务器临时故障 | 等待几分钟后重试 |
| `insufficient_quota` | 账户余额不足 | 前往控制台充值 |
### Q4: 如何查看 API 使用情况和费用？
登录 [ElkAPI 控制台](https://api.elkapi.com) 查看：
* 📊 API 调用统计
* 💰 费用明细
* 📈 使用趋势图表
## 功能特性
使用 Cherry Studio + ElkAPI，您可以：
* 💬 **多模型对话** - 在同一界面使用不同的 AI 模型
* 🖼️ **图像理解** - 支持图像输入的多模态对话
* 📝 **上下文管理** - 智能管理对话历史和上下文
* 🎨 **自定义提示词** - 创建和管理提示词模板
* 📊 **对话导出** - 导出对话记录为 Markdown 等格式
* 🔄 **模型对比** - 同时使用多个模型并对比输出
## 支持与帮助
如果您在使用过程中遇到任何问题：
* 📚 [ElkAPI 文档中心](https://docs.elkapi.com)
* 📧 技术支持：[support@elkapi.com](mailto:support@elkapi.com)
***
立即注册 ElkAPI，获取您的 API 密钥，开启 AI 之旅！