Nano Banana Pro API 原比例输出完整指南:实现图片原尺寸生成
AIHub代理API
国内直连企业级中转,600+全模型支持
Nano Banana Pro API 原比例输出完整解析
详解 Nano Banana Pro API 如何实现原比例输出,重点掌握在图片编辑场景下省略 aspect_ratio 参数的正确用法,彻底解决图片尺寸被裁切或拉伸的问题。
在使用 Nano Banana Pro API 进行图片生成与编辑时,尺寸控制往往是最容易被忽略、却最容易出问题的环节。很多开发者在编辑图片时,明明只想换背景或优化细节,最终却发现输出图片变成了正方形,或者比例与原图完全不一致。
官方文档中明确说明 aspect_ratio 参数只支持 10 种固定比例,这让不少人误以为 API 无法保持任意原图尺寸。但实际上,在图片编辑场景中,Nano Banana Pro 提供了一种更简单也更可靠的解决方案:省略 aspect_ratio 参数即可实现原尺寸输出。
读完本文,你将完整掌握 Nano Banana Pro API 原比例输出的工作原理、使用方式以及在不同场景下的正确参数配置方法。
Nano Banana Pro API 的尺寸输出逻辑说明
在 Nano Banana Pro API 中,图片输出尺寸并不是完全自由控制的,而是根据请求类型采用不同的处理策略。整体来看,可以分为两类模式。
第一类是纯文本生成图片
当请求中只包含文本描述而不包含任何输入图片时,API 会按照文生图模式处理。这种情况下,如果没有显式指定 aspect_ratio 参数,模型会默认输出 1:1 的正方形图片。这一默认行为主要是为了兼容社交媒体、内容平台和通用展示场景。
第二类是图片编辑模式
当请求中包含一张或多张输入图片,并对其进行编辑、替换背景或风格调整时,API 的处理逻辑会发生变化。在这种模式下,只要不传递 aspect_ratio 参数,Nano Banana Pro 会自动读取输入图片的原始宽高比,并按照完全一致的尺寸输出生成结果。这正是实现原比例输出的核心机制。
理解这一差异非常重要。很多尺寸异常的问题,并不是模型生成错误,而是请求模式不符合原比例输出的触发条件。
Nano Banana Pro 原比例输出的核心要点
下表概括了实现原比例输出所需掌握的关键规则,也是整篇文章的技术核心。
| 要点 | 说明 | 实际价值 |
|---|---|---|
| 省略参数法 | 图片编辑时不传 aspect_ratio | 自动保持原图尺寸 |
| 10 种固定比例 | 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9 | 仅用于文生图或强制改比例 |
| 默认行为差异 | 文生图默认 1:1,改图默认原尺寸 | 理解 API 行为的关键 |
只要理解并正确应用以上三点,就可以在绝大多数场景中避免尺寸异常问题。
Nano Banana Pro 原比例输出的关键原理
Nano Banana Pro(即 Gemini 3 Pro Image)在处理图片请求时,会根据请求内容采用两套完全不同的默认行为。
在纯文本生成图片的场景中,如果请求只包含文本描述而没有任何输入图片,API 会进入文生图模式。这种模式下,如果没有显式指定 aspect_ratio,系统会默认输出 1:1 的正方形图片。
而在图片编辑场景中,行为逻辑完全不同。当请求中包含一张或多张输入图片,并且模型需要在这些图片基础上进行编辑时,只要你没有传递 aspect_ratio 参数,API 就会自动读取输入图片的原始宽高比,并以相同的尺寸输出编辑结果。
正是这种差异化的默认策略,使得“省略 aspect_ratio 参数”成为实现原比例输出的关键技巧。
为什么原比例输出机制是合理且可靠的
从设计角度来看,这种机制非常符合实际使用场景。
当用户上传一张图片进行编辑时,通常期望输出结果在尺寸和比例上与原图保持一致。如果强制要求开发者手动计算比例并传参,不仅增加了开发复杂度,还容易因为比例计算误差或不在支持范围内,导致图片被裁切或拉伸。
Nano Banana Pro 通过在改图场景下自动继承原图尺寸,既降低了使用门槛,也最大程度保证了视觉一致性。这也是官方在文档中隐含推荐的实践方式。
Nano Banana Pro 原比例输出官方比例规则说明
需要特别注意的是,aspect_ratio 参数本身依然存在严格限制。官方 API 文档明确规定,该参数只接受以下 10 种预设比例,不能自定义任意宽高比。
| 比例 | 1K 尺寸示例 | 典型用途 | 常见场景 |
|---|---|---|---|
| 1:1 | 1024×1024 | 头像、图标 | 社交媒体头像 |
| 2:3 | 832×1248 | 竖版海报 | 手机壁纸 |
| 3:2 | 1248×832 | 横版照片 | 相机标准比例 |
| 3:4 | 864×1152 | 竖版内容 | 小红书封面 |
| 4:3 | 1152×864 | 传统显示器 | PPT 配图 |
| 4:5 | 896×1120 | 社交内容 | |
| 5:4 | 1120×896 | 打印照片 | 8×10 英寸 |
| 9:16 | 768×1344 | 竖版视频 | 短视频封面 |
| 16:9 | 1344×768 | 横版视频 | YouTube 封面 |
| 21:9 | 1536×658 | 超宽屏画面 | 电影画面 |
这些比例仅在你显式指定 aspect_ratio 时才会生效。如果你的目标是保持输入图片的原始尺寸,那么正确做法不是从中选择一个“接近的比例”,而是直接省略该参数。
Nano Banana Pro 原比例输出快速上手示例
下面是一个最简化的示例,用于演示如何在图片编辑场景下保持原尺寸输出。
在这个示例中,整个请求没有任何 aspect_ratio 相关配置,因此 API 会自动使用输入图片的原始宽高比输出结果。
Nano Banana Pro 原比例输出的三种典型场景对比
| 场景 | aspect_ratio 配置 | 输出结果 | 适用用途 |
|---|---|---|---|
| 文生图 指定比例 | 例如 16:9 | 1344×768(1K) | 海报、封面 |
| 文生图 默认 | 不传参数 | 1024×1024 | 正方形图标 |
| 改图 原尺寸 | 不传参数 | 与原图一致 | 产品图编辑 |
三种场景的正确使用方式
当进行纯文本生成图片,并且对输出尺寸有明确要求时,必须显式指定 aspect_ratio 参数,否则只能得到默认的正方形图片。
当进行图片编辑并希望保持原图尺寸时,这是本文的核心场景,只需确保请求中包含图片,并完全省略 aspect_ratio 参数。
如果在图片编辑过程中确实需要改变构图比例,例如将横图裁成正方形封面,则可以在包含输入图片的同时,显式传递 aspect_ratio 参数。
常见问题解答
1.为什么我省略 aspect_ratio 后,图片还是变成了正方形?
最常见原因是请求中并未真正传入图片,API 会自动按文生图模式处理。原比例输出只在包含输入图片的编辑场景下生效。
2.原图尺寸不在 10 种支持比例中怎么办?
这正是省略参数法的优势所在。API 会按原图真实尺寸输出,而不是强制裁切到某个固定比例。
3.如何快速验证原比例输出是否生效?
可以在测试阶段打印或比对输出图片的宽高,确认其与输入图片保持一致。
核心要点回顾
在 Nano Banana Pro API 中实现原比例输出,并不依赖复杂参数配置,而是正确理解默认行为。
图片编辑场景下,省略 aspect_ratio 参数即可保持原图尺寸
文生图与改图是两种完全不同的模式,默认输出规则不同
aspect_ratio 仅适用于需要强制指定尺寸的场景,并且只能使用官方支持的 10 种比例
掌握这一技巧后,无论是产品图处理、人像修图还是背景替换,都可以稳定输出原尺寸图片,避免不必要的后期尺寸调整。
