Cherry Studio配置 banana pro 4K和分辨率教程
官方入口:Cherry Studio 官方下载
适用范围:Cherry Studio 中支持 Gemini imageConfig 透传的图像模型;4K 参数不适用于普通聊天模型。
版本与验证:2026-09-28 核对本文配置项、步骤和资料入口,补齐验证与排错说明。历史截图可能显示旧模型名称;以当前模型能力为准。未在真实账号中验证付费模型调用。
配置速查
| 配置项 | 填写内容 | 注意事项 |
|---|---|---|
| 图像模型 | 当前分组可用的 Gemini 图像模型 | 选支持图像输出与该分辨率的模型。 |
| imageConfig 类型 | JSON 对象 | 不要将整个对象再包成字符串。 |
| aspectRatio | 9:16 | 按图像模型支持的比例填写。 |
| imageSize | 4K | 小写 i、大写 S;不能写 ImageSize。 |
| 流式开关 | 关闭 | 先验证非流式图片响应。 |
还没有 API Key?注册获取免费体验额度 · 已注册:进入控制台创建 API Key
为此工具单独创建令牌,并设置合理额度和模型权限。截图中的模型仅作示例,以账号当前可用模型为准;不要公开密钥或上传含密钥的配置文件。
第 1 步:先接通图像模型
按 基础配置教程 接入 apizt,添加当前分组可用、支持 Gemini imageConfig 的图像生成模型。先用默认参数得到一张图,再增加尺寸参数。普通聊天模型不会因添加此参数获得图像能力。
第 2 步:添加 JSON 自定义参数
打开当前图像模型的自定义参数,名称填 imageConfig,类型选 JSON,值为下方对象。注意 imageSize 的大小写;不要给整个对象加引号。
{
"aspectRatio": "9:16",
"imageSize": "4K"
}第 3 步:使用非流式请求并验收
先关闭流式开关,发起一个简短的生成请求。保存返回的原始图片,查看像素尺寸与比例;聊天窗口预览大小不能证明输出是 4K。参数被拒绝时核对模型与协议是否支持此字段。


怎样确认配置已生效
- 请求中出现正确的 imageConfig 对象。
- 返回图片可保存,并核对像素尺寸。
接入失败时逐项检查
| 现象 | 检查与处理 |
|---|---|
| 返回文本而不是图片 | 确认选中图像生成模型及正确协议,检查输出配置。 |
| 尺寸参数被忽略 | 核对 imageSize 的大小写、JSON 类型和模型支持。 |
| 400 参数错误 | 去掉额外参数从默认图像生成开始,再逐项加入比例和尺寸。 |
资料与下一步
遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。