Appearance
Cherry Studio
Cherry Studio 是一款桌面 AI 客户端，适合把聊天、模型管理、提示词和绘图工作流放在同一个本地界面里。新手如果想找一个日常聊天和画图都能用的本地客户端，可以优先选择 Cherry Studio；如果只是调试接口，请改用 Apifox 或 Postman。
下载和官方入口
| 入口 | 地址 | 说明 |
|---|---|---|
| 官方网站 | https://cherry-ai.com | 了解 Cherry Studio 和下载入口。 |
| 官方下载 | https://cherry-ai.com/download | 新手优先从这里选择系统安装包。 |
| 下载文档 | https://docs.cherry-ai.com/docs/en-us/cherry-studio/download | 查看不同系统安装说明。 |
| 官方文档 | https://docs.cherry-ai.com | 查看模型服务、Provider 和配置说明。 |
| GitHub Releases | https://github.com/CherryHQ/cherry-studio/releases | 查看发布版本和安装包。 |
平台支持
| 平台 | 支持状态 | 推荐方式 | 注意事项 |
|---|---|---|---|
| Windows | 支持 | 官方下载页安装包 | 不建议从非官方镜像下载。 |
| macOS | 支持 | 官方下载页安装包 | Intel 和 Apple Silicon 以官方标注为准。 |
| Linux | 支持 | AppImage、deb、rpm 或压缩包 | 具体包类型以 GitHub Releases 当前版本为准。 |
| Web / Docker | 不适用 | 使用桌面端 | Cherry Studio 主要是桌面 AI 客户端。 |
安装后检查
- 打开 Cherry Studio，确认能进入模型服务或供应商设置页面。
- 在 AIDMX 令牌管理 创建一个专用于 Cherry Studio 的 API Token。
- 在 AIDMX 控制台确认要使用的模型名称；聊天模型和绘图模型要分别确认。
- 如果团队多人共用文档，不要把真实 Token 写进截图或共享配置。
配置 AIDMX
| 配置项 | 填写内容 | 说明 |
|---|---|---|
| 提供商名称 | AIDMX | 便于在模型列表和会话中识别。 |
| 提供商类型 | NewAPI 或 OpenAI 兼容类型 | 以当前 Cherry Studio 版本实际选项为准。 |
| API 密钥 | 你的 AIDMX API Token | 从 令牌管理 复制，也可以理解为请求 Token。 |
| API 地址 | https://ai.aidmx.xyz/v1 | 注意保留末尾 /v1，不要重复填写为 /v1/v1。 |
| 模型名称 | 控制台可用模型名称 | 聊天模型和绘图模型需要分别添加。 |
先在 AIDMX 令牌管理页复制 API Key。建议为 Cherry Studio 单独创建一个 Token，后续在使用日志中能更快定位请求来源。
打开 Cherry Studio 的模型服务设置，新增供应商并选择 NewAPI 或 OpenAI 兼容类型。供应商名称可以填写 AIDMX，API 地址填写 https://ai.aidmx.xyz/v1，API 密钥填写刚复制的 Token。
如果模型列表没有自动出现，进入模型管理或添加模型页面，手动录入 AIDMX 控制台可用的模型名称。模型名称需要和控制台展示一致，避免因为别名或拼写差异导致请求失败。
回到聊天页面后，先确认当前会话没有停留在其它供应商。新建会话或打开已有会话都可以，只要模型选择器中能看到刚添加的 AIDMX 模型即可。
在模型选择器中切换到 AIDMX 模型，发送一条简短消息测试回复。测试通过后，再把它保存到常用助手、提示词或工作区配置中。
如需使用图像生成能力，先添加支持绘图的模型。绘图模型与聊天模型可以共用同一个 AIDMX Provider，但模型选择要分开处理：聊天页面选择聊天模型，绘图页面选择控制台中可用于图像生成的绘图模型。
进入绘图页面后，选择刚添加的绘图模型，输入提示词并发起生成。若客户端要求额外参数，优先保持默认值，确认基础链路可用后再调整尺寸、数量和质量等选项。
成功验证
- Cherry Studio 能显示 AIDMX Provider。
- 使用 AIDMX 聊天模型发送消息后能收到回复。
- 使用绘图模型时能创建图像生成任务或返回图片。
- AIDMX 使用日志 中出现对应调用，能看到 Token、模型名称和消耗记录。
常见失败
- 模型列表为空：手动新增模型名称，或刷新模型列表后再保存。
- 连接测试失败：确认 API 地址是否为 https://ai.aidmx.xyz/v1。
- 回复失败但日志成功：检查客户端是否启用了不兼容参数，必要时先关闭 stream 测试。
- 多 Provider 混淆：确认会话或绘图页面当前选择的是 AIDMX 模型。
- 绘图无结果：确认所选模型支持图像生成，而不是普通聊天模型。
下一步
- 使用 Playground 对比参数效果。
- 到 使用日志 查看消耗。
- 阅读 OpenAI 兼容工具 处理通用错误。