Cherry Studio配置 banana pro 4K和分辨率教程

更新于

适用范围:Cherry Studio 中支持 Gemini imageConfig 透传的图像模型;4K 参数不适用于普通聊天模型。

版本与验证:2026-09-28 核对本文配置项、步骤和资料入口,补齐验证与排错说明。历史截图可能显示旧模型名称;以当前模型能力为准。未在真实账号中验证付费模型调用。

配置速查

配置项填写内容注意事项
图像模型当前分组可用的 Gemini 图像模型选支持图像输出与该分辨率的模型。
imageConfig 类型JSON 对象不要将整个对象再包成字符串。
aspectRatio9:16按图像模型支持的比例填写。
imageSize4K小写 i、大写 S;不能写 ImageSize。
流式开关关闭先验证非流式图片响应。

还没有 API Key?注册获取免费体验额度 · 已注册:进入控制台创建 API Key

为此工具单独创建令牌,并设置合理额度和模型权限。截图中的模型仅作示例,以账号当前可用模型为准;不要公开密钥或上传含密钥的配置文件。

第 1 步:先接通图像模型

按 基础配置教程 接入 apizt,添加当前分组可用、支持 Gemini imageConfig 的图像生成模型。先用默认参数得到一张图,再增加尺寸参数。普通聊天模型不会因添加此参数获得图像能力。

第 2 步:添加 JSON 自定义参数

打开当前图像模型的自定义参数,名称填 imageConfig,类型选 JSON,值为下方对象。注意 imageSize 的大小写;不要给整个对象加引号。

{
  "aspectRatio": "9:16",
  "imageSize": "4K"
}

第 3 步:使用非流式请求并验收

先关闭流式开关,发起一个简短的生成请求。保存返回的原始图片,查看像素尺寸与比例;聊天窗口预览大小不能证明输出是 4K。参数被拒绝时核对模型与协议是否支持此字段。

步骤1
历史版本界面参考;配置值与步骤以本文文字和所装版本为准。点击图片可页内放大。
步骤2
历史版本界面参考;配置值与步骤以本文文字和所装版本为准。点击图片可页内放大。

怎样确认配置已生效

  1. 请求中出现正确的 imageConfig 对象。
  2. 返回图片可保存,并核对像素尺寸。

接入失败时逐项检查

现象检查与处理
返回文本而不是图片确认选中图像生成模型及正确协议,检查输出配置。
尺寸参数被忽略核对 imageSize 的大小写、JSON 类型和模型支持。
400 参数错误去掉额外参数从默认图像生成开始,再逐项加入比例和尺寸。

资料与下一步

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。