Cherry Studio 接入 miaotoken教程：配置 gpt-image-2 图像生成模型

Cherry Studio 是一款支持 Windows、macOS 和 Linux 的多模型 AI 客户端。通过“自定义服务商”功能，可以接入兼容 OpenAI API 的第三方服务，在同一个客户端中管理文本和图像模型。

本文介绍如何把 api.miaotoken.cn 接入 Cherry Studio，并以该平台公开模型列表中的 gpt-image-2 为例完成图片生成配置。

重要说明：

1. api.miaotoken.cn 属于第三方服务，并非 Cherry Studio 官方服务。
2. 截至 2026 年 8 月 7 日，该站公告注明服务不对中国大陆用户开放，请遵守平台地区限制及相关条款。
3. 本文中的 gpt-image-2 是该平台提供的模型 ID。实际上游来源、图片尺寸、编辑能力、价格及可用参数，应以平台最新说明和实际测试为准。

一、准备工作

开始前需要准备：

• 较新版本的 Cherry Studio
• 符合平台服务地区要求的 api.miaotoken.cn 账户
• 在平台创建的有效 API Key
• 可用余额以及 gpt-image-2 模型权限

Cherry Studio 官方下载地址：

https://docs.cherryai.com.cn/cherry-studio/download

截至本文发布时，api.miaotoken.cn 的公开模型页面将 gpt-image-2 列在 codex-企业 分组中。平台可能调整模型分组，实际使用前请再次查看控制台。

二、创建 API Key

打开并登录：

https://api.miaotoken.cn

进入控制台后，打开“令牌”页面，点击“添加令牌”。

令牌名称可以填写：

cherry-studio

根据需要设置额度和有效期，然后提交并复制生成的 API Key。

请勿在 CSDN 截图、聊天记录或公开代码仓库中展示完整密钥。如果密钥已经泄露，应立即删除并重新创建。

三、添加自定义服务商

打开 Cherry Studio，依次进入：

设置 → 模型服务 → 服务商列表底部“+ 添加”

按下面的内容填写：

配置项	填写内容
提供商名称	MiaoToken，也可以自定义
提供商类型	OpenAI
API 密钥	在平台创建的 API Key
API 地址	https://api.miaotoken.cn

注意，Cherry Studio 官方的 NewAPI 接入指南要求这里填写根地址，因此不要添加 /v1，也不要填写 /v1/images/generations 等完整接口路径。

填写完成后，点击 API Key 右侧的“检查”按钮。如果验证失败，先检查密钥、账户状态和服务地区限制。

四、添加 gpt-image-2 模型

在刚添加的服务商中打开“模型管理”。

可以先点击“管理”获取模型列表。如果列表中存在 gpt-image-2，直接添加即可；没有显示时，也可以手动添加：

模型 ID：gpt-image-2
端点类型：图像生成（OpenAI）

模型 ID 必须完全一致，不能改成中文名称，也不要改变大小写或连字符。

保存后，确保服务商右上角的启用开关已经打开。端点类型尤其重要：如果误设为普通文本模型，它不会出现在 Cherry Studio 的绘画页面中。

五、生成第一张图片

在 Cherry Studio 顶部标签栏点击“+”，进入“启动台”，然后打开“绘画”。

在底部输入区选择：

服务商：MiaoToken
模型：gpt-image-2

首次测试建议使用默认尺寸和单张生成，提示词尽量简单，例如：

一张干净的电商产品摄影图：白色陶瓷咖啡杯放在浅灰色桌面上，
自然侧光，背景简洁，真实摄影质感，画面中不要出现文字和水印。

点击“生成”后，检查图片是否正常显示，同时到平台控制台查看调用记录和费用。连接测试成功后，再逐步调整尺寸、质量和其他参数。

六、常见问题排查

问题	检查方法
401 Invalid token	检查 API Key 是否正确、是否带有空格、是否已经失效
403 Forbidden	检查账户、服务地区及模型分组权限
404 Not Found	Cherry Studio 的 API 地址应填写根域名，检查是否错误添加了 /v1
找不到模型	确认模型 ID 精确为 gpt-image-2，并检查账户可用模型列表
绘画页面不显示模型	将端点类型设置为“图像生成（OpenAI）”，并启用服务商
429 或额度不足	检查余额、令牌限额、请求频率及并发任务
返回 400	恢复默认尺寸、质量和生成数量，再逐项调整参数
返回链接但不显示图片	更新 Cherry Studio，并确认第三方接口返回格式兼容当前客户端

七、隐私和费用提示

通过第三方服务生成图片时，提示词、参考图片及请求参数可能经过该服务商，并发送给实际上游模型提供方处理。

因此不建议上传身份证件、客户资料、未公开设计稿等敏感内容。最好为 Cherry Studio 单独创建一个 API Key，设置合理限额，并定期查看调用记录。

图片模型的计费方式和可用参数可能随平台调整。正式批量生成前，应先用默认参数生成一张图片，核对结果和账单记录。

八、总结

整个配置流程可以概括为：

1. 在 api.miaotoken.cn 创建 API Key。
2. 在 Cherry Studio 中添加 OpenAI 类型的自定义服务商。
3. API 地址填写 https://api.miaotoken.cn，不带 /v1。
4. 添加模型 ID gpt-image-2。
5. 将端点类型设为“图像生成（OpenAI）”。
6. 在“启动台 → 绘画”中选择模型并测试生成。

完成配置后，可以在 Cherry Studio 中统一管理文本和图像模型。不过，第三方服务的可用地区、模型权限、价格、稳定性和数据处理方式，仍需以平台实时说明为准。

参考资料

• Cherry Studio 自定义服务商：https://docs.cherryai.com.cn/pre-basic/providers/zi-ding-yi-fu-wu-shang
• Cherry Studio 接入 NewAPI：https://docs.cherryai.com.cn/pre-basic/providers/newapi
• Cherry Studio 绘画功能：https://docs.cherryai.com.cn/cherry-studio/preview/drawing
• MiaoToken：https://api.miaotoken.cn

推荐标签：Cherry Studio、gpt-image-2、AI 绘画、OpenAI 兼容接口、API 教程