Skip to main content
POST
Nano Banana 2.1 的编辑和生成是同一个接口:在 parts 里同时放提示词和参考图即可。验证日期:2026-10-08。请使用绑定「Nano Banana 2.1 画图」分组的 API Key,并设置环境变量 HEIHUZI_API_KEY。 参考图以 base64 写在 inlineData 里,mimeType 填图片的实际格式(本页验证了 image/png 和 image/jpeg)。 下载参考图 reference.png(1024×1024 蓝色杯子)到运行目录后,可以直接运行下面的单图编辑示例。
响应保存为 edit.json,结构与图像生成相同,图片在 candidates[].content.parts[].inlineData。

请求参数

object[]
required
放一条 role: "user" 消息,parts 里依次写提示词和参考图。
object
与图像生成相同,比例和清晰度写在 imageConfig 里。带参考图且不填 aspectRatio 时,输出沿用参考图的比例:本次输入 16:9 图片、只填 imageSize: "1K",返回 1376×768。

已验证的编辑场景

均使用 aspectRatio: "1:1"、imageSize: "1K"(另注明的除外),返回 JPEG。

Python 两张参考图

这段完整代码已用 requests==2.32.5 真实执行。运行前把 reference.png 和 palette.png 下载到运行目录;输出为一张 1024×1024 红色杯子,保存为 edited-1.jpg。

使用 Google GenAI SDK 编辑

官方工具包从 google-genai 1.49.0 起才有 image_size 参数,1.47.0 实测会报错。这段代码已用 google-genai==2.28.0(需要 Python 3.10 及以上)真实执行,读取 reference.png,把蓝色杯子改为红色,保存为 sdk-edited-1.jpg。
参考图越多、越大,请求体越大。本页 14 张参考图的请求实测约 57 秒返回,响应约 7 MB。