-preview 后缀的名字也不接受。
系列里的模型共用同一套请求形状，所以换模型就是改 model 一个词。
系列总览
默认选 Nano Banana 2：它在每个分辨率上都明显更快，参数又完全一样，
换过去不用改任何集成代码。只有当那点额外质量值得每张图多花十秒左右时，
才换成 Nano Banana Pro。
参数
所有参数都在input 里。外层信封——model、input、callback_url——
见异步任务 API。
下面五个字段就是全集。input 里出现任何其他键都会被 invalid_params 拒掉，
所以拼错字段名会立刻报错，不会被静默忽略。
分辨率档位
image_size 缩放的是整幅画面，而不是把某一条边钉死，所以宽幅图在 4K 下
长边远超 4096 像素。实测，两个可用模型完全一致：
文件体积随之变化：
1K 约 0.4–0.7 MB，2K 约 2.4–3.0 MB，4K 约 7.5–8.2 MB。
产物一律是带 C2PA 内容凭证清单的 JPEG。
画幅比例
接受十个值。gemini-3-pro-image 在 1K 下的实测像素：
每种比例都落在标称值的 1％ 以内。不传
aspect_ratio 时，纯文生图得到
1024 × 1024；传了 images 则跟随参考图的形状。
图生图与多图合成
在images 里传参考图就是编辑或合成。每一项要么是 https URL，
要么是 base64 data URI——裸 base64 字符串会被拒，http 也会被拒。
aspect_ratio、image_size、n 同样生效
——在 4K 下做编辑，产出确实是 4096 × 4096。
URL 是在任务被受理之后由服务端去取的，所以坏的参考图不会报 400，
而是让任务变成 failed。两个错误码告诉你是哪一层放弃的：
两者都发生在任何模型计算之前，所以失败很快，重试成本也低。
时延
异步数据来自 30 个任务、并发 12 的压测，同步数据来自单次调用。 这些数字用来判断量级，不是服务等级承诺。
异步多花约 0.9 秒的往返，换来的是剩下 20–40 秒不用挂着连接。压测下排队
0–11 秒，已经计入上面的端到端数字。
同步接口形态
三种同步形态对两个可用模型都有效，且都把图片放在响应体里，不给 URL：下一步
Playground
直接在页面里发一次真实请求，看任务跑完。
异步任务 API
信封、轮询闭环、回调与错误表。