Cherry Studio 配置指南

在 Cherry Studio 中使用 MaiToken 作为 API 后端

准备工作

在开始之前，请确保：

已安装 Cherry Studio

从 Cherry Studio 官网下载并安装适合您操作系统的版本
已获取 MaiToken API 密钥

登录 MaiToken 控制台获取您的 API 密钥（以 sk- 开头）

提示： 如果还没有 MaiToken 账户，请先在 MaiToken 注册并获取 API 密钥。

配置步骤

第一步：打开模型提供商设置

启动 Cherry Studio
点击左下角的设置图标（齿轮图标）
在设置页面中选择 模型服务 或 提供商

第二步：添加 MaiToken 提供商

点击提供商列表右上角的 + 按钮，添加新提供商
在弹出的对话框中：
- 名称：填写 MaiToken（或您喜欢的名称）
- 提供商类型：选择 New API（兼容 OpenAI 格式）
点击确认完成创建

第三步：填写 API 配置

在 MaiToken 提供商的配置页面中，填写以下信息：

配置项	填写内容
API 密钥	您的 MaiToken API 密钥（`sk-xxxxxxxxxxxx`）
API 地址	`https://api.maitoken.com/v1/`

第四步：添加模型

在提供商配置页面，点击 添加模型 按钮
填写模型信息：
- 模型 ID：输入您想使用的模型 ID（见下方推荐模型列表）
- 端点类型：选择 OpenAI
点击保存

推荐模型：

模型名称	模型 ID	特点
Claude Opus 4.6	`claude-opus-4-6`	最强大，适合复杂任务
Claude Sonnet 4.6	`claude-sonnet-4-6`	性能与速度平衡，推荐日常使用
Claude Haiku 4.5	`claude-haiku-4-5-20251001`	快速响应，适合简单任务
GPT-5	`gpt-5`	最新 OpenAI 旗舰模型
GPT-4o	`gpt-4o`	高质量对话与多模态
GPT-4o Mini	`gpt-4o-mini`	快速且经济
Gemini 2.5 Pro	`gemini-2.5-pro`	Google 多模态旗舰

您可以重复上述步骤，按需添加多个模型。

第五步：启用并验证

确保提供商右侧的开关处于开启状态
点击 检查连接 或测试按钮，验证配置是否正确
如果提示连接成功，说明配置完成

开始使用

配置完成后：

返回 Cherry Studio 主界面
在对话框顶部的模型选择器中，选择刚才添加的 MaiToken 模型
开始对话

常见问题

Q1: 连接测试失败？

解决方案：

检查 API 密钥 是否正确，确认以 sk- 开头
确认 API 地址 填写为 https://api.maitoken.com/v1/（注意末尾的斜杠）
在 MaiToken 控制台确认密钥未过期且账户余额充足
检查网络连接，确保能访问 https://api.maitoken.com

Q2: 模型列表中找不到我的模型？

Cherry Studio 使用手动添加模型的方式，直接在添加模型时输入模型 ID 即可。可在 MaiToken 模型列表查看所有可用模型 ID。

Q3: 常见错误码说明

错误信息	原因	解决方法
`401 Unauthorized`	API Key 无效或过期	重新获取 API Key
`429 Too Many Requests`	请求频率超限	稍等片刻后重试
`500 Internal Server Error`	服务器临时故障	等待几分钟后重试
`insufficient_quota`	账户余额不足	前往控制台充值

支持与帮助

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

📚 MaiToken 文档中心
📚 Cherry Studio 官方文档

开始使用 MaiToken — 立即注册 MaiToken，获取您的 API 密钥，在 Cherry Studio 中开启高效 AI 之旅！