跳转到主要内容
Nano Banana 2.1 是 Google 在 2026 年 10 月发布的 Nano Banana 2 更新版,文字渲染、信息图排版和多轮编辑的一致性更好,单价也比 Nano Banana 2 低。在老张API上,模型 ID 是 gemini-nano-banana-2.1,每次 $0.045,1K、2K、4K 同价,不需要 Google 账号。
出图失败变多时,先看各模型现在是否正常。 图片模型实时状态每 5 分钟更新 GPT Image 和 Nano Banana 的成功率,并给出重试和换模型的做法。

能力与参数

2K、4K 出图低于 Google 官方标准价(按每张输出图片折算):
  • 2K:Google 官方 $0.0504,老张API $0.045
  • 4K:Google 官方 $0.113,老张API $0.045
模型来自 Google 官方渠道。价格为 2026 年 10 月 7 日公开价格配置,Google 官方价 2026 年 11 月 5 日核对,最新价格见模型与价格,各模型的对比见官方价对比。
Nano Banana 2.1 生成的雨后傍晚街角咖啡馆,招牌写着 BANANA CAFE

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

Nano Banana 2.1 编辑后的同一家咖啡馆,变成下雪的清晨,招牌文字保留

「编辑图片」示例把同一张图改成下雪的清晨

参数与限制

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 继续可用、价格不变,已有项目不需要迁移。
2026 年 10 月 14 日用本页「生成图片」示例的提示词,在两个模型上各生成一张 2K、16:9:
Nano Banana 2.1 生成的雨后傍晚街角咖啡馆,招牌和遮阳篷上都写着 BANANA CAFE

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

Nano Banana 2 生成的雨后傍晚街角咖啡馆,黄色霓虹招牌写着 BANANA CAFÉ

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 保存
单次请求通常需要 15–40 秒,4K 更久。各分辨率的输出像素和 2026 年 10 月 7 日、14 日实测的单次耗时如下,单价都是 $0.045: 示例把超时设为 300 秒,你的客户端和代理也请留足时间。偶尔有请求超过这个时间,超时后先查调用日志再决定是否重发。

生成图片

下面生成一张 16:9 的 2K 图片。需要 4K 时把 imageSize 改为 4K;比例从上表中任选。
成功后会得到 nb21-generate-1.jpg 等文件,扩展名随返回的图片格式变化。

编辑图片

把本地图片编码为 inlineData,和编辑指令放在同一条消息的 parts 中。多张参考图按顺序追加,提示词里用「第一张图」「第二张图」指代;最多 14 张。
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 示例中的 https://example.com/your-image.jpg 需要替换为你的图片 URL,图片要能被公网直接访问;本地图片请使用 Python 示例,它会把图片转成 data URL。

错误与计费

参数不合法时返回 HTTP 400,不扣费。例如 aspectRatio 不在 14 种之内(如 7:3)时返回 400,错误信息可能为空,请对照参数与限制检查比例。请求体过大时返回 413,把大图改成图片 URL即可。
imageSize 传 512 不会被拒绝,而是按 1K 出图并扣费。 截至 2026 年 10 月 8 日,会输出 1K 图片并扣 $0.045。需要 512px 请改用 Nano Banana 2,否则传 1K。
计费要点:
  • 每次调用 $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:
级别越高,构图和文字推敲越充分,耗时也越长。老张API只按次计费,三档都是 $0.045/次(Google 官方则会按思考 tokens 另外计费)。 另外设置 "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 生成的雨后傍晚街角咖啡馆,招牌写着 BANANA CAFE

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

Nano Banana Pro 生成的雨后傍晚欧式街角咖啡馆,香蕉形霓虹招牌写着 BANANA CAFE,鹅卵石路面反光

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。

相关文档