Gemini 图片不清晰时,别先追加“高清、4K、8K、电影感”。这几个词可能影响画面风格,却不会替你设置下载文件的像素。正确做法是分三层检查:
- 观感层:提示词有没有讲清用途、主体、关系、材质、光线和构图?
- 请求层:当前模型是否收到它支持的
image_size与aspect_ratio? - 文件层:下载后的宽×高是否对应官方当前像素表?
先看文件层,可以少走很多弯路。尺寸不对,查参数、模型、路由或下载;尺寸正确但画面仍糊,才去修提示词或换模型。大文件不会自动修复错误文字、人物变形和糟糕构图。
| 你看到的问题 | 先检查 | 下一步 |
|---|---|---|
| 画面平、材质假、主体不突出 | 用途、关系、光线、材质、验收条件 | 每轮只修改一个主要问题 |
| 明明请求 4K,下载文件却很小 | 模型、参数位置、比例、下载方式 | 修请求或使用“下载完整尺寸” |
| 网页预览清楚,保存后变糊 | 文件宽高、格式、是否保存了缩略图 | 重新导出,不要继续堆“高清词” |
| 宽高正确,但文字或细节错误 | 提示词、模型能力、参考图约束 | 修内容,不要只升分辨率 |
先确认你用的是 App 还是 API
Gemini App、官方开发者 API、Vertex AI 和第三方网关不是同一个产品合同。套餐、模型、参数、配额、价格和下载方式不能互相套用。
Gemini App:用完整尺寸下载,再看文件
Google 当前的 Gemini Apps 图片帮助要求使用专门的“下载完整尺寸”控制。帮助页描述的是:没有 Google AI 方案时完整尺寸为 1K,有方案时为 2K;付费用户还可以用 Pro 重新生成以增加细节。
这不是“App 保证 4K”的承诺,也不是开发者 API 的参数说明。你在 App 里看到什么模型和下载控制,就按当前账号实际界面操作,保存后再检查宽高。不要把 API 单价、API image_size 或第三方网关能力写进 App 套餐表。
Gemini Developer API:尺寸参数与自然语言分开
Google 当前 Gemini 图片生成文档把 gemini-3.1-flash-image 作为通用平衡路线,把 gemini-3-pro-image 定位为复杂专业素材路线。当前 Interactions API 在 response_format 下设置图片类型、比例和尺寸:
pythonfrom google import genai import base64 client = genai.Client() interaction = client.interactions.create( model="gemini-3.1-flash-image", input=( "为手工陶瓷品牌生成 16:9 网站首图。画面右侧是一只哑光黑色杯子," "放在浅色石材台面上;左上方柔和窗光照亮杯身,显示细微陶土纹理。" "左半边保留干净文案区,不要添加文字、Logo、第二只杯子或强烈反光。" ), response_format={ "type": "image", "aspect_ratio": "16:9", "image_size": "4K", }, ) if interaction.output_image: with open("gemini-hero.png", "wb") as output_file: output_file.write(base64.b64decode(interaction.output_image.data))
尺寸值使用大写 1K、2K、4K。Gemini 3.1 Flash Image 还记录了 512px 档位,但不能据此推断所有图片模型都支持它。Google 已发布正式 GA ID,并退役了对应的 preview ID;不要从旧文章复制 -preview 名称。
请求的逻辑很清楚:
input讲画面要表达什么;response_format.image_size讲目标尺寸档位;response_format.aspect_ratio讲横竖比例;- 下载文件的宽×高负责最终验收。
4K 不是永远 4096×4096
“4K”在 Gemini 图片 API 里是尺寸档位,不是所有比例都固定为 4096 像素长边。Google 当前为 Gemini 3.1 Flash Image 与 Gemini 3 Pro Image 列出的常用行是:
| 宽高比 | 1K | 2K | 4K |
|---|---|---|---|
| 1:1 | 1024×1024 | 2048×2048 | 4096×4096 |
| 16:9 | 1376×768 | 2752×1536 | 5504×3072 |
| 4:5 | 928×1152 | 1856×2304 | 3712×4608 |
因此,16:9 的 4K 文件不是旧文常写的 4096×2304,也不是 4096×4096。比例和模型共同决定应返回哪一行。模型更新后,必须重新看官方表,不能把这些数字当作永久通则。
编辑现有图片时,模型可能沿用输入图尺寸或比例。需要复现结果时,应同时记录输入图、模型、请求尺寸、比例和下载宽高,而不是只记一句提示词。
中文高清提示词,要写成创作要求
“一张高端商业级 4K 图片,超清,细节丰富”没有说明主体、关系和验收条件。更稳定的中文提示词至少回答七个问题:
- 用途:网页首图、公众号封面、电商主图还是海报?
- 主体:画面中心是谁或什么?正在做什么?
- 关系:主体在左还是右,前景和背景怎么组织,谁大谁小?
- 材质与光线:哪些纹理、反射和阴影需要看清?
- 构图:横竖比例、镜头远近、留白和裁切安全区是什么?
- 保留与禁止:编辑时什么不能变,什么绝对不要出现?
- 验收条件:哪种错误会让图片不能交付?
例如,一张网站首图可以这样写:
“为手工陶瓷品牌生成 16:9 网站首图。画面右侧只有一只哑光黑色杯子,完整露出杯柄,放在浅色石材台面上。柔和窗光从左上方照入,显示杯身细微陶土纹理和自然接触阴影。左半边保持安静留白,方便后期用 HTML 放标题。不要生成文字、Logo、第二只杯子或夸张反光。如果杯柄被裁掉、左侧出现杂物或材质像塑料,结果不合格。
这里真正提高可控性的不是“高清”两个字,而是用途、空间关系、材质、留白和失败条件。镜头与摄影术语可以帮助传达视觉意图,但不能保证模拟真实相机,更不能替代像素参数。
下载后,用本地工具核验宽和高
先把 App 的完整尺寸图片或 API 返回图片保存到本地。macOS 可以用系统自带的 sips:
bashsips -g pixelWidth -g pixelHeight gemini-hero.png
安装了 ImageMagick 时,可以用:
bashidentify gemini-hero.png
把输出宽×高与当前模型、比例和尺寸表逐项对照。生产任务最好保留一条简短记录:
- 使用的是 App、Google API、Vertex 还是 provider;
- 页面或响应显示的模型;
- 请求的
image_size与aspect_ratio; - 保存文件的格式、宽和高;
- 使用的提示词版本与参考图;
- 最终失败在尺寸、文字、细节还是构图。
像素核验只能证明交付尺寸,不能证明画面语义准确、压缩无损、文字正确、图片可商用或适合印刷。内容和权利仍需单独审核。Google 还说明 Gemini 生成图片包含 SynthID;这不等于可见的角标 Logo。
四种失败,对应四条修复路线
尺寸不对:查请求和下载
先确认模型是否支持该档位,再看 image_size 是否大写、是否放在当前 response_format 内。App 用户确认使用了“下载完整尺寸”,API 用户确认保存的是图片 payload,而不是预览缩略图。
尺寸正确但画面糊:查创作要求
补上缺失的材质、光线、主体关系或验收条件。一次只修改一个主要目标,才能知道哪一步有效。复杂文字、品牌一致性或多元素任务可以评估 Pro,但更贵或更强的模型也不保证每张图都能交付。
预览好、下载差:查产品面
在确认保存宽高之前,把它当作下载或产品界面问题,不要立刻归因于提示词或普遍产品退化。重新使用完整尺寸下载,记录账号 surface、下载方式和文件属性;单个用户观察不能证明所有账号都有同一问题。
文字、数量或细节不稳定:改变交付方式
Google 明确提醒,图片模型不一定严格遵守要求的图片数量;含文字图片更适合先准备准确文案,再把文字交给图片请求。法律条款、价格、菜单正文等必须准确的内容,优先在 HTML 或设计工具中排版,不要让图片模型成为唯一事实 owner。
中国用户还要单独核对接入路线
中文 Google 结果和 gl=cn 参数不能证明当前浏览器使用中国大陆 IP,也不能证明官方 API 在你的地区、付款方式和网络环境中直接可用。开发前应查 Google 当前 available regions、账单和项目可用模型。
第三方网关可以解决支付、兼容接口、模型切换或运维成本问题,但它提供的是自己的 provider 合同。本轮公开资料里,LaoZhang API 的 provider 页面仍出现 preview 风格的 route 名称,而 Google 已宣布对应官方 preview ID 退役。因此本文不发布一个未经控制台验证的网关模型 ID。
如果确实需要 provider 路线,先做一张低风险测试图,并核对当前控制台模型映射、尺寸、价格、失败扣费、配额、数据条款和支持范围;保存文件后再跑同一套像素核验。官方直连仍是能力基线。provider 无法说明实际调用了什么时,应停止迁移生产任务。
当前价格属于独立且易变的 reader job,可查看 Nano Banana Pro 4K 成本指南。免费额度和 429 限流排障也各有自己的 owner,本页不复制旧额度或旧价格。
什么时候不要升到 4K
- 最终页面只显示小图,1K/2K 的保存像素已经明显高于渲染尺寸。
- 构图、人物、文字或产品细节尚未定稿;先低档位改对内容,再生成一次最终图。
- 问题是 Logo、文字、手部、透视或品牌一致性;升分辨率只会得到更大的错误。
- 只看到“4K”标签,却没有检查保存文件宽×高。
- 参考图含敏感人物、客户数据或品牌资产,而 provider 数据处理条款尚未核对。
- 当前模型、参数或下载路径无法确认;此时只报告真实观察,不承诺 4K。
可靠的顺序不是“加高清词 -> 买更贵套餐”,而是:先写清画面任务,再请求模型支持的尺寸和比例,保存实际文件,最后检查宽高和内容。确认失败发生在哪一层之后,才决定下一笔成本应该花在提示词、模型、分辨率还是接入路线。



