gemini-3.1-flash-image，支持文生图、多张参考图编辑、同步生成和异步任务，并提供 1K、2K、4K 三档输出。
对于需要一个模型覆盖日常图片生成、多种版式和高分辨率交付的新项目，它通常是 Nano Banana 系列中更通用的起点。
Gemini 3.1 Flash Image API 支持什么
Google 将该模型定位为质量、速度和高频使用之间的平衡方案，并强调构图比例、多语言文字渲染和编辑能力。详细上游说明见 Gemini 3.1 Flash Image 模型页。
输出尺寸与宽高比
选择 1K、2K 或 4K
- 1K：适合提示词迭代、网页配图、社交媒体图片和缩略图。
- 2K：适合商品图、营销素材以及需要进一步裁切或编辑的设计资产。
- 4K：适合确实需要更多像素的最终交付；响应体积和处理时间也会增加。
imageSize 必须使用大写值，并放在 generationConfig.imageConfig 内。Google 上游文档还列有 0.5K，但当前 API 只接受 1K、2K 和 4K。
十四种版式比例
除常见的1:1、4:3、3:4、16:9、9:16 外，Flash Image 还支持 1:4、1:8、4:1 和 8:1，适合网页横幅、长图海报和特殊画布。完整枚举见参数页。
常见使用场景
- 商品场景图、广告素材和品牌视觉草图；
- 文章配图、社交媒体图片和活动海报；
- 需要 2K 或 4K 工作像素的设计流程；
- 保留产品主体、替换背景或调整风格的图片编辑；
- 需要异步执行并在后台查询结果的生成任务。
contents[].parts[] 数组，每张参考图使用独立的 inlineData。异步任务支持 1～16 张来源图；Google Search grounding 等能力仍以当前官方模型和公开 OpenAPI 为准。
什么时候选择 Lite 或 Pro
Pro 并不自动适合所有任务。应根据成品通过率、返工时间和实际交付要求决定是否升级，具体差异见模型对比。
响应解析与调用方式
图片通常作为inlineData 返回，也可能与文字内容同时出现。客户端必须扫描全部 candidates[].content.parts[]，读取 mimeType 后再保存图片。同步接口适合能够保持连接的服务端调用；代理超时、队列任务或页面离开后仍需继续生成时，应使用异步接口。
当前请求价格见价格页；网关 RPM、上游 429 和可用性目标见流量能力与可用性。这些指标不代表每分钟一定完成相同数量的图片。
配置生成参数
查看尺寸、十四种宽高比和编辑输入结构。
运行 API 示例
复制同步、异步和图片编辑代码。