Nano Banana Pro API 原比例输出完整指南:实现图片原尺寸生成

Nano Banana Pro API 原比例输出完整指南:实现图片原尺寸生成

AIHub代理API

国内直连

企业级中转,600+全模型支持

比官方
便宜77.7%
免费试用福利
注册即送$0.2美金
02
01
00
:
5
4
3
2
1
0
9
8
7
6
5
4
3
2
1
0
GPT-5.1 / Claude-4.5 / Gemini-3Pro
NanoBanana2 / MJ / Sora2
高并发不封号
OpenAI接口兼容
立即注册体验
1000+ 新用户今日注册

Nano Banana Pro API 原比例输出完整指南:实现图片原尺寸生成

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 社交内容 Instagram
5:4 1120×896 打印照片 8×10 英寸
9:16 768×1344 竖版视频 短视频封面
16:9 1344×768 横版视频 YouTube 封面
21:9 1536×658 超宽屏画面 电影画面

这些比例仅在你显式指定 aspect_ratio 时才会生效。如果你的目标是保持输入图片的原始尺寸,那么正确做法不是从中选择一个“接近的比例”,而是直接省略该参数。


Nano Banana Pro 原比例输出快速上手示例

下面是一个最简化的示例,用于演示如何在图片编辑场景下保持原尺寸输出。

import openai
import base64

client = openai.OpenAI(
api_key="YOUR_API_KEY",
base_url="https://vip.apiyi.com/v1"
)

with open("input.jpg", "rb") as f:
image_base64 = base64.b64encode(f.read()).decode()

response = client.chat.completions.create(
model="gemini-3-pro-image-preview",
messages=[{
"role": "user",
"content": [
{
"type": "image_url",
"image_url": {
"url": f"data:image/jpeg;base64,{image_base64}"
}
},
{
"type": "text",
"text": "将图片背景改为日落场景"
}
]
}]
)

在这个示例中,整个请求没有任何 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 种比例

掌握这一技巧后,无论是产品图处理、人像修图还是背景替换,都可以稳定输出原尺寸图片,避免不必要的后期尺寸调整。