📣 致读者：本文档专为非开发者（普通用户）编写。 本文不涉及任何代码、命令行操作或 Docker 部署等技术内容。您只需拥有一台电脑，按照下面的图文指引一步步操作，即可轻松使用 Cherry Studio 客户端畅享 New API 提供的各种 AI 大模型服务。
一、准备工作
在正式开始之前，请您准备好以下两样东西：
| 序号 | 需要什么 | 去哪里获取 |
|---|---|---|
| ① | New API 的访问地址（URL） | https://api-1.yjs.im |
| ② | New API 的令牌（Key） | 登录 New API 管理后台后，在「令牌管理」页面创建（详见下文） |
二、在 New API 中获取令牌（Key）
💡 请按以下步骤操作：
2.1 登录 New API 管理后台
在浏览器中打开您的 New API 地址（ https://api-1.yjs.im），使用您的账号登录。
2.2 进入令牌管理页面
登录后，在左侧菜单栏中找到并点击 「令牌管理」 或 「令牌」。
2.3 创建一个新令牌
- 点击页面上的 「添加令牌」 按钮
- 填写以下信息：
- 名称：给令牌起个名字，比如”我的CherryStudio”（方便以后识别）
- 分组：⚠️ 这是控制该令牌能使用哪些模型的核心设置！ 分组决定了令牌可以调用的模型范围。(分组可以在模型广场查看)
- 额度：设置使用额度。如果是无限额使用，可以留空或设为 0（代表不限）
- 过期时间：设置令牌的有效期，也可以选择”永不过期”
- 模型权限：勾选允许使用的模型（不确定就留空）
- 点击 「提交」 或 「保存」
2.4 复制令牌（Key）
创建成功后，页面会显示一串以 sk- 开头的密钥。点击复制按钮，把这串密钥保存好！
⚠️ 重要提醒： 这串密钥相当于您的”银行卡密码”，千万不要泄露给不信任的人。
三、下载安装 Cherry Studio（或其它客户端）
3.1 下载 Cherry Studio
打开浏览器，访问 Cherry Studio 官方网站：
🌐 官方下载地址：https://www.cherry-ai.com/
在首页找到「下载」按钮，根据您的操作系统选择对应版本：
| 操作系统 | 下载文件名示例 |
|---|---|
| 🪟 Windows | Cherry-Studio-Setup-x.x.x.exe |
| 🍎 macOS (Intel 芯片) | Cherry-Studio-x.x.x-x64.dmg |
| 🍎 macOS (Apple M 芯片) | Cherry-Studio-x.x.x-arm64.dmg |
| 🐧 Linux | Cherry-Studio-x.x.x.AppImage |
如果不确定自己的 Mac 是什么芯片：点击屏幕左上角苹果图标 →「关于本机」→ 查看「芯片」一栏。
3.2 安装 Cherry Studio
- Windows 用户：双击下载的
.exe文件，按照安装向导点击「下一步」直到完成 - Mac 用户：双击下载的
.dmg文件，把 Cherry Studio 图标拖拽到「应用程序」文件夹 - Linux 用户：右键
.AppImage文件 → 属性 → 勾选「允许作为程序执行」，然后双击运行
安装完成后，双击桌面图标（或从开始菜单/启动台找到 Cherry Studio）打开软件。
四、在 Cherry Studio 中配置 New API
这是最关键的一步，请仔细按顺序操作：
4.1 打开设置
启动 Cherry Studio 后，点击软件界面左侧或底部的 「设置」 图标（⚙️ 齿轮图标）。
4.2 添加 New API 作为模型提供商
-
在设置页面中，找到 「模型服务」 或 「API 提供商」 选项卡
-
点击 「添加」 按钮
-
在提供商列表中找到并选择 「New API」 或 「OpenAI 兼容接口」（因为 New API 完全兼容 OpenAI 格式）
-
选择后点击 「确定」
4.3 填写连接信息
在弹出的配置表单中，填写以下三项关键信息：
| 配置项 | 填写内容 | 说明 |
|---|---|---|
| API 地址 | 您拿到的 New API 地址 | 例如：https://api-1.yjs.im |
| API 密钥 | 之前复制的令牌（以 sk- 开头的那串） | 粘贴进来即可 |
4.4 添加模型
点击 「获取模型列表」
添加自己需要的模型
五、开始使用 Cherry Studio 聊天
5.1 新建对话
回到 Cherry Studio 主界面，点击 「新对话」 或 「+」 按钮。
5.2 选择模型
在对话界面的顶部或设置中，找到 模型选择器（下拉菜单），选择您想使用的 AI 模型。
💡 不同模型各有擅长：写代码选 Claude，日常聊天选 GPT5，深度推理选 DeepSeek-Reasoner，您可以多试试看哪个更适合自己的需求。
5.3 开始聊天
在底部的输入框中输入您的问题，按 Enter（回车键） 发送。AI 模型就会开始回复您啦！
5.4 Cherry Studio 特色功能速览
Cherry Studio 作为专业客户端，提供了很多便捷功能：
| 功能 | 说明 |
|---|---|
| 📝 多会话管理 | 可以同时开启多个对话，左侧列表轻松切换 |
| 📎 文件上传 | 支持上传图片、PDF、Word 等文件让 AI 阅读分析 |
| 🔍 联网搜索 | 部分模型支持开启联网搜索功能 |
| 📚 知识库 | 可以搭建自己的知识库，让 AI 基于您的资料回答 |
| 🎨 AI 绘画 | 如 New API 集成了 Midjourney，可在 Cherry Studio 中生成图片 |
| 🎵 AI 音乐 | 如 New API 集成了 Suno，可生成音乐 |
| 📊 Prompt 模板 | 内置丰富的提示词模板，一键套用 |
六、常见问题解答（FAQ）
Q1：连接失败，提示"网络错误"怎么办？
- 确认 New API 服务器是否在正常运行——在浏览器中直接访问该地址看看能否打开
- 检查本地网络连接是否正常
- 如果服务器在国外，可能需要科学上网工具
Q2：模型列表加载不出来？
- 令牌（Key）可能已过期或额度用完，请登录 New API 后台检查
- 令牌的模型权限可能被限制，确认已勾选需要使用的模型
Q3：聊天时提示"余额不足"或"额度已用完"？
您的令牌额度已耗尽。请登录 New API 管理后台，在「令牌管理」中找到您的令牌，点击「充值」增加额度。
Q4：如何切换不同的 AI 模型？
在 Cherry Studio 的对话界面顶部，有一个模型选择的下拉菜单，点击即可切换。切换后发送的新消息将使用新选择的模型。
Q5：New API 支持哪些 AI 模型？
这取决于您的 New API 管理员配置了哪些渠道。常见的有 OpenAI GPT 系列、Anthropic Claude 系列、Google Gemini 系列、DeepSeek 系列、Midjourney（AI 绘画）、Suno（AI 音乐）等几十种模型。具体可咨询您的服务商。
Q6：令牌（Key）不小心泄露了怎么办？
立即登录 New API 管理后台，在「令牌管理」中找到对应的令牌，点击「禁用」或「删除」，然后重新创建一个新的令牌。
Q7：Cherry Studio 收费吗？需要付费吗？
Cherry Studio 是完全免费的客户端软件。您只需要为使用 AI 模型的费用付费（通过 New API 的令牌额度）。也就是说，费用来自 New API 端，不是 Cherry Studio 端。
七、快速操作检查清单
| 步骤 | 操作 | ✓ 完成 |
|---|---|---|
| 1 | 获取 New API 的访问地址 | ☐ |
| 2 | 登录 New API 后台，创建并复制令牌（Key） | ☐ |
| 3 | 在 cherry-ai.com 下载 Cherry Studio | ☐ |
| 4 | 安装 Cherry Studio | ☐ |
| 5 | 在 Cherry Studio 设置中添加 New API 提供商 | ☐ |
| 6 | 填写 API 地址（记得加 /v1）+ 粘贴 API Key | ☐ |
| 7 | 测试连接，刷新模型列表 | ☐ |
| 8 | 新建对话，选择模型，开始聊天 🎉 | ☐ |
八、获取帮助
- 🌐 New API 官方文档：https://docs.newapi.pro/
- 🌐 New API 官方网站：https://www.newapi.ai/
- 🌐 Cherry Studio 官网：https://www.cherry-ai.com/
- 🐙 New API GitHub 仓库：https://github.com/QuantumNous/new-api
📝 文档版本：v1.0 | 适用对象：非开发者 / 普通用户 | 推荐客户端：Cherry Studio