Gemini 3 Pro Image API

Gemini 3 Pro Image（Nano Banana Pro）是面向专业设计、复杂版式和高分辨率交付的图片生成与编辑模型。API 模型 ID 为 gemini-3-pro-image，支持 1K、2K、4K 输出，并可通过同一套 Gemini 请求结构完成文生图和多张参考图编辑。 Pro 的价值不在于“任何提示词都更好”，而在于复杂文字、版式约束、高保真产品稿或高价值成品可能需要更强的推理与视觉处理能力。

​

Gemini 3 Pro Image API 适合做什么

Google 将该模型定位为推理驱动的专业图片模型，重点场景包括复杂设计、高保真产品效果图、文字渲染和事实型可视化。上游能力与限制见 Gemini 3 Pro Image 模型页。

​

适合使用 Pro 的场景

​

复杂版式和文字图形

海报、信息图、包装概念和带文字的营销素材通常同时要求构图、文字位置和视觉层级。此类任务的验收成本高，适合把 Pro 与 Flash Image 放在同一条件下比较。

​

高价值产品视觉

珠宝、腕表、消费电子、汽车或专业设备等产品图，对材质、反射、结构和细节一致性要求更高。应使用真实业务素材评估成品通过率，而不是根据模型名称直接判断。

​

4K 最终交付

4K 适合确实需要额外像素的印刷、展示或后期设计流程。提示词迭代阶段仍可先用 1K 或 2K，确定构图后再提高尺寸。

​

输出尺寸和宽高比

imageSize 支持大写 1K、2K、4K，省略时按 1K 处理。可用宽高比为 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9 和 21:9。 Pro 不提供 Flash Image 的 1:4、1:8、4:1、8:1 扩展比例。如果任务既需要专业处理又需要特殊画布，应先确认比例是否满足交付要求。完整参数见参数页。

​

4K 响应处理

图片数据以 Base64 形式嵌入 JSON，4K 响应会明显大于 1K。生产环境应：

• 为客户端和反向代理设置足够的响应大小与超时；
• 避免把完整 inlineData.data 写入日志或错误监控；
• 解码后及时转存到对象存储；
• 无法稳定保持长连接时使用异步任务；
• 记录 responseId、modelVersion 和自有文件地址，便于排查。

响应格式不应写死为 JPEG 或 PNG。客户端必须读取 inlineData.mimeType，并遍历全部 candidates[].content.parts[] 查找图片。

​

Pro 与 Flash Image 怎么选

模型选择应以实际成品通过率、人工修正时间和交付要求为准，而不是把 Pro 当作默认升级。 精确请求价格以价格页为准。网关请求容量、上游 429 和可用性目标见流量能力与可用性；这些平台级指标不是 Pro 的出图速度或完成量保证。

​

API 接入入口

同步调用使用 POST /v1beta/models/gemini-3-pro-image:generateContent。对于 4K、后台队列或短超时客户端，使用 /v1/images/tasks，设置 action=generate|edit，再轮询任务状态。