gemini-nano-banana-2.1,每次 $0.045,1K、2K、4K 同价,不需要 Google 账号。
能力与参数
2K、4K 出图低于 Google 官方标准价(按每张输出图片折算):
- 2K:Google 官方 $0.0504,老张API $0.045
- 4K:Google 官方 $0.113,老张API $0.045

「生成图片」示例的输出:2K,16:9

「编辑图片」示例把同一张图改成下雪的清晨
参数与限制
1:1 和 16:9 的输出像素见调用前准备中的表格,其他比例见 Google 图像生成文档。
五个 Nano Banana 模型的价格与能力对比见 Nano Banana 总览。
和 Nano Banana 2 怎么选
两者的请求结构和响应解析完全相同,切换时只改模型 ID。新项目选 Nano Banana 2.1
1K–4K 出图单价更低,文字和排版更稳定。
需要 0.5K 预览图用 Nano Banana 2
Nano Banana 2.1 没有
512 档。Nano Banana 2 继续可用、价格不变,已有项目不需要迁移。
Nano Banana 2.1,2K,16:9:24 秒,$0.045

Nano Banana 2,2K,16:9:22 秒,$0.055
调用前准备
1
创建 API Key
在令牌管理创建 API Key,计费模式选择「按量优先」(推荐)或「按次计费」。按量优先的令牌可以同时调用按量和按次计费的模型,按次计费的令牌只能调用按次计费的模型。
2
设置密钥并安装依赖
3
保存共用脚本
把 Nano Banana 总览中的
nano_banana.py 保存到当前目录。本页的 Python 示例导入它,cURL 示例也用它把响应文件保存为图片:read_image():读取本地图片save_images():从 Gemini 原生响应的parts[].inlineData或 OpenAI 兼容响应的 data URL 中取出 Base64 数据,解码后按 PNG、JPEG 或 WebP 保存
示例把超时设为 300 秒,你的客户端和代理也请留足时间。偶尔有请求超过这个时间,超时后先查调用日志再决定是否重发。
生成图片
下面生成一张 16:9 的 2K 图片。需要 4K 时把imageSize 改为 4K;比例从上表中任选。
- cURL
- Python
nb21-generate-1.jpg 等文件,扩展名随返回的图片格式变化。
编辑图片
把本地图片编码为inlineData,和编辑指令放在同一条消息的 parts 中。多张参考图按顺序追加,提示词里用「第一张图」「第二张图」指代;最多 14 张。
- cURL
- Python
nb21_edit.py 后,单图编辑可以直接使用上一步生成的图片(文件名以实际保存的为准),多图合成时换成你自己的图片:
用图片 URL 传入大图
整个请求体不要超过 20MB。参考图较大或已经在 CDN 上时,用fileData 传图片 URL,不必下载再编码:
- 把
https://cdn.example.com/your-photo.jpg换成你的图片 URL,mimeType与图片格式一致。 fileData和inlineData可以写在同一个parts里,按顺序作为第一张、第二张参考图。- URL 需要能被服务端直接下载,具体要求见传入大图与图片 URL。
搜索接地
在请求中加入googleSearch 工具,模型会先检索再出图,适合需要最新事实或真实地标外观的图片。下面同时启用网页搜索和图片搜索:
searchTypes必须写成对象。不设置时只启用网页搜索,只写imageSearch时只用图片搜索。- 每次是否检索、用哪种搜索由模型决定,实际用到的检索词在
groundingMetadata中。 - 目前不能把搜索到的真实人物图片用作参考;向最终用户展示接地结果时,需要按 Google 搜索接地说明展示搜索建议。
- 开启搜索接地的请求,在 $0.045 之外每次检索另收 $0.014。检索 2 次就是 $0.073,调用日志会写明检索次数,见 Nano Banana 总览的计费规则。
OpenAI 兼容格式
已有 OpenAI SDK 代码时,把base_url 设为 https://api.laozhang.ai/v1,model 改为 gemini-nano-banana-2.1 即可。
这种格式不能设置比例、分辨率和输出格式,输出 1K 的 PNG 图片,画幅由模型按内容决定,常见为 16:9 横图。需要固定比例、2K、4K 或 JPEG 时,用上面的 Gemini 原生格式。示例关闭了 SDK 的自动重试,避免超时后重复生成和扣费。
生成图片
- cURL
- Python
编辑图片
- cURL
- Python
https://example.com/your-image.jpg 需要替换为你的图片 URL,图片要能被公网直接访问;本地图片请使用 Python 示例,它会把图片转成 data URL。
错误与计费
参数不合法时返回 HTTP 400,不扣费。例如aspectRatio 不在 14 种之内(如 7:3)时返回 400,错误信息可能为空,请对照参数与限制检查比例。请求体过大时返回 413,把大图改成图片 URL即可。
计费要点:
- 每次调用 $0.045,不随分辨率、思考级别、参考图数量或生成 / 编辑而变化。
- 开启搜索接地时,每次检索另收 $0.014。
- 上游返回 HTTP 200 即扣费,没有返回图片也一样;原因与避免方法见避免没有图片的扣费。
- 客户端超时不等于请求失败,重试前先在调用日志确认请求状态。
常见问题
从 Nano Banana 2 切换要改什么?
把模型 ID 从gemini-3.1-flash-image 改为 gemini-nano-banana-2.1,请求结构和响应解析不变。
切换前检查两处:
- 请求里用了
"imageSize": "512"的,改成1K或继续用 Nano Banana 2;不改的话,Nano Banana 2.1 会输出 1K 图片并照常扣费。 - 没有设置
thinkingLevel时,Nano Banana 2.1 默认按medium思考,Nano Banana 2 默认是minimal。想要更快出图,显式设为minimal。
思考级别怎么调?会影响价格吗?
使用 Gemini 原生格式时,在generationConfig.thinkingConfig.thinkingLevel 中设置级别,可选 minimal、medium、high:
"includeThoughts": true 时,响应会多出带 "thought": true 的思考文字和中间草图,保存时只取最后一张不带 thought 的图片。
4K 和 1K 价格一样吗?
一样,1K、2K、4K 都是 $0.045/次,调用日志里每次扣的就是这个数。Google 官方按输出 tokens 计费,4K 每张约 $0.113,见 Google 官方价格。只出 1K 小图时,Nano Banana 2 Lite 的单价更低。Nano Banana 2.1 和 Pro 怎么选?
先用 Nano Banana 2.1($0.045/次)。依赖世界知识、多语言文字、精确品牌细节的成片,或编辑时需要风格参考图、最多 5 张人物参考图,再换 Nano Banana Pro(gemini-3-pro-image,$0.09/次)。两者请求结构相同,用自己的提示词在两个模型上各试几次再定。
同一提示词、2K、16:9,2026 年 10 月 14 日 Nano Banana 2.1 用时 24 秒,Nano Banana Pro 用时 46 秒:

Nano Banana 2.1,2K,16:9:24 秒,$0.045

Nano Banana Pro,2K,16:9:46 秒,$0.09
不用 Google 账号或 AI Studio 密钥也能调用吗?
能。只需要default 分组的老张API密钥,请求发到 https://api.laozhang.ai,用本页的 Gemini 原生或 OpenAI 兼容格式都可以。
请求失败或没出图会扣费吗?
上游返回非 200(参数错误的 400、未进入生成的 429 和 5xx)不扣费;返回 HTTP 200 即按一次扣费,没有图片也一样。规则见错误与计费和扣费与失败规则。能输出 JPEG 吗?
能。使用 Gemini 原生格式时,在generationConfig.imageConfig 中加入 imageOutputOptions:
mimeType可选image/png(默认)和image/jpeg;传image/webp返回 400,不扣费。compressionQuality只对 JPEG 生效,取 0–100,数值越小文件越小。- 返回的
inlineData.mimeType会随之变为image/jpeg。同一张 1K 方图,PNG 约 1.1 MB,JPEG 约 40–60 KB,单价不变。 - OpenAI 兼容格式不能指定格式,固定输出 PNG。
OpenAI 兼容格式为什么返回横图?
OpenAI 兼容格式不能传比例,画幅由模型按提示词决定,常见为 16:9。需要方图或竖图时,改用 Gemini 原生格式并设置aspectRatio。
相关文档
- Nano Banana 总览:五个模型对比、两种调用方式、计费规则与共用代码
- Nano Banana 2 API:需要 0.5K 输出时使用
- Nano Banana 2 Lite API:只需 1K 时的轻量模型
- Nano Banana Pro API:复杂构图与专业成片
- Gemini 协议:原生请求结构与 SDK 配置
- Google Nano Banana 2.1 模型说明:官方能力与限制
- Google 图像生成文档:比例、像素尺寸与参考图上限