Nano Banana 2.1 API ： 用文字和参考图生成最高 4K 的 AI 图片
在这里直接在线试用 Nano Banana 2.1：写一段提示词，最多加 14 张参考图，选好分辨率和比例，一次最多出 4 张图。满意之后，用一个 API Key、一份余额，通过 Nano Banana 2.1 API 在你自己的产品里调用同一个模型。
- 最多 14 张参考图
- 1k、2k 或 4k
- 按张计费
- 开放 Nano Banana 2.1 API
功能亮点
Nano Banana 2.1 API 的核心能力
文生图，也能用参考图
提示词最长 8000 字符，用来描述你要的画面；也可以加最多 14 张参考图，在提示词里用 @Image1、@Image2… 点名每一张。不传 image_urls 就是纯文生图，传了就能让新图保留同一个商品、角色或风格。
1k、2k、4k 三档分辨率
每个任务都可以选 resolution 1k、2k 或 4k。1k 出图最快；4k 是最高的一档，适合印刷品、首屏大图和之后还要裁切的画面。
15 种比例，包括超宽和超长
从 1:1、4:5、9:16 到 21:9，还有横幅用的 4:1、8:1 和长条用的 1:4、1:8，做横幅、长图不用再从方图里裁。auto 在只有 1 张参考图时跟随它的比例，多张时由模型决定，没有参考图时按 1:1。
可调的思考程度
thinking_level 决定模型动笔之前对提示词想得多深：minimal、medium 或 high。每个任务单独设置，三档同价。
联网搜索和图片搜索
打开 enable_web_search 或 enable_image_search，Nano Banana 2.1 生成时可以搜索网页或图片，适合提示词里有需要先查一查的内容。两个搜索开关都不影响价格。
一次最多 4 张，可以指定 seed
num_outputs 可以设成 1–4。多张并行生成，4 张的耗时和 1 张差不多。还可以传 seed（0–2147483647）固定随机数的起点：同一个任务里的第 i 张用 seed + i。
简介
什么是 Nano Banana 2.1？
- 模型 ID
nano-banana-2.1- 分辨率
- 1k / 2k / 4k
- 画面比例
- 15 种
- 参考图
- 最多 14 张
- 每次张数
- 1–4 张
- 提示词
- 最长 8000 字符
- 价格
- 每张 $0.0702 起
Nano Banana 2.1 是一个 AI 图片模型：给它一段提示词，可以再加几张参考图，它就能生成 1k、2k 或 4k 的成图。提示词最长 8000 字符，还能用 @Image1、@Image2… 直接点名每张参考图，一次请求就能说清哪个商品、哪个角色、哪种风格放在哪里。它还会在动笔之前先想一想提示词，需要时可以搜索网页或图片。
在 NanoAPI 上，Nano Banana 2.1 是产品 nano_banana 下的模型 nano-banana-2.1。每个任务带一段提示词和最多 14 张参考图，返回 1–4 张图，每张都有一个完整的 PNG 原图和一个长边不超过 1024 像素的 JPEG 预览图，链接公开、不会过期。分辨率、比例、张数和思考程度每个任务都由你来定。
比例是 Nano Banana 2.1 的一大特点：除了常见的 1:1、4:5、3:2、16:9、21:9，它还能直接画出 8:1、1:8 这样的极端比例，网站横幅、长条信息图按真实的形状生成，不用从方图里裁。
你可以先在本页顶部的工作台里在线使用 Nano Banana 2.1，再在自己的应用里通过 https://api.nanoapi.ai/v1 调用 Nano Banana 2.1 API。两边用同一份预付余额、同样的每张单价，而且只为拿到的图片付费：没生成出来的那几张退回，整个任务失败的全额退回。
价格
Nano Banana 2.1 API 价格
按张计费，单价按分辨率区分：只为任务实际返回的图片付费，思考程度、搜索开关和 seed 都不影响价格。
| 价格 | 1k 每张 | 2k 每张 | 4k 每张 |
|---|---|---|---|
| 每张 | $0.0702 | $0.0936 | $0.1404 |
实时的每张单价。费用 = 每张单价 × 张数；只按生成出来的张数扣费，生成失败全额退回。
使用步骤
如何使用 Nano Banana 2.1 API
- 1
第 1 步: 获取 API Key
用 Google 登录 NanoAPI，在控制台的 API Keys 页面创建一个 Key。每个 API 请求都用它鉴权，请只放在你的服务端。
- 2
第 2 步: 充值余额
在控制台的充值页面充值。余额以美元预付，永不过期，NanoAPI 的所有模型共用，生图和生视频花的是同一份钱。
- 3
第 3 步: 创建任务
调用 POST /v1/tasks，传 model nano-banana-2.1、prompt、resolution、aspect_ratio、num_outputs 和 thinking_level，需要时再加上 image_urls 和搜索开关。任务不到 1 秒就进入队列，几秒内冻结所请求张数的费用。
- 4
第 4 步: 获取图片
任务结束后推送一次到你的 webhook_url，也可以每隔 15 秒以上轮询 GET /v1/tasks/{task_id}。1k 一张约 30 秒，2k 约 1 分半，4k 约 3 分半；图片在 outputs[].url。
为什么选 NanoAPI
为什么在 NanoAPI 上使用 Nano Banana 2.1 API
一个 Key，一份余额
同一个 API Key、同一份预付余额，可以调用 NanoAPI 的所有图片和视频模型，都走同一个接口 POST /v1/tasks，返回同一种任务对象。
只为拿到的图片付费
每个任务按请求的张数冻结费用。4 张里有 1 张没生成出来（例如被内容审核拦下）时，任务仍然成功，那一张的钱退回余额；一张都没出来时，全额退回。
回调或轮询
传一个 webhook_url，任务结束时收到一次推送，按 Standard Webhooks 规范签名（验证签名是可选的）；也可以轮询单个任务，或者一次查询一批任务 ID。
安全重试，消费有上限
带上 Idempotency-Key，重发的请求会返回已经建好的任务，不会重复扣费。还可以在控制台给每个 Key 设每小时、每天或总的消费限额。
每个请求都能在控制台查到
控制台里能看到每个请求的状态、模型、输入、费用和结果，按产品统计的每日用量和每一笔余额变动，还能管理 API Key 和回调签名密钥。
先在线试，再接入
本页工作台用的是同一个 Nano Banana 2.1 模型、同样的价格，你试出来的效果就是用户拿到的效果。文档还提供一份 llms.txt，方便交给 AI 编程助手。
使用场景
用 Nano Banana 2.1 API 能做什么
商品图和电商图
把商品照片作为 @Image1 传进来，换一个背景、放进生活场景或节日活动画面里，用 2k 或 4k 出图，直接用在商品详情和广告里。
横幅和宽幅版式
一次请求就能生成 21:9 的首屏大图、4:1 和 8:1 的网站横幅，或者 1:4、1:8 的竖长条，不用再从方图里裁。
保持角色和品牌一致
用最多 14 张参考图，让同一个角色、吉祥物，或者品牌的配色和风格，在一整组图片里保持一致。
给你的应用加上生图功能
把 Nano Banana 2.1 文生图接进设计工具、社交应用或内容流水线：批量创建任务，通过回调拿到图片，PNG 链接原样保存即可。
01什么是 Nano Banana 2.1 API？
Nano Banana 2.1 API 让你的应用通过 HTTP 调用 Nano Banana 2.1 模型生成图片。在 NanoAPI 上调用 POST /v1/tasks，传 model nano-banana-2.1、提示词和出图参数，可以再带最多 14 张参考图，然后通过回调或轮询拿到 1–4 张图。
02Nano Banana 2.1 API 怎么收费？
按张计费：所选分辨率的每张单价 × 生成成功的张数。任务按 num_outputs 的张数冻结费用，只按实际返回的张数扣费，其余退回；任务失败全额退回。thinking_level、两个搜索开关和 seed 都不影响价格。实时价格见上面的表格、价格页和 GET /v1/products。
03最多能用几张参考图？支持哪些格式？
每个任务最多 14 张，以公开的 http(s) 链接放在 image_urls 里，在提示词里按顺序写 @Image1、@Image2… 引用。支持 JPEG、PNG、WebP、AVIF、GIF（取第一帧）、BMP 和 TIFF。不支持 HEIC / HEIF，iPhone 照片请先转成 JPEG，本页工作台会自动转换。透明背景的 PNG 会先铺成白底再使用。
04Nano Banana 2.1 支持哪些分辨率和比例？
resolution 可选 1k、2k、4k。aspect_ratio 可选 auto、1:1、3:2、2:3、4:3、3:4、4:5、5:4、9:16、16:9、21:9，以及 4:1、1:4、8:1、1:8 这几种极端比例。只有 1 张参考图时 auto 跟随它的比例；多张时由模型决定，尺寸不固定，需要固定比例请直接选；没有参考图时 auto 按 1:1。
05只生成出一部分图片会怎样？
任务仍然算成功，outputs 里只有生成出来的那几张，可能比 num_outputs 少，例如其中一张被内容审核拦下。只按拿到的张数扣费，其余退回余额。只有一张都没生成出来时，任务才是失败，全额退回。
06thinking_level、联网搜索和图片搜索有什么用？
thinking_level（minimal、medium 或 high）决定模型动笔之前对提示词想得多深。enable_web_search 和 enable_image_search 让模型生成时可以搜索网页或图片，适合提示词里有需要先查一查的内容。thinking_level 每个任务都要传，两个搜索开关可选，都不影响价格。
07生成要多久？结果是什么格式？
1k 一张约 30 秒，2k 约 1 分半，4k 约 3 分半。多张并行生成，一个任务出 4 张和出 1 张的耗时差不多。每张图都有一个 PNG 原图（outputs[].url）和一个 JPEG 预览图（preview_url），链接公开、不会过期。
08可以先在线试用 Nano Banana 2.1 再接入吗？
可以。用 Google 登录后直接用本页顶部的工作台：它和 API 用的是同一个 Nano Banana 2.1 模型、同样的价格和同一份余额，写代码之前就能确认效果和费用。
开始用 Nano Banana 2.1 创作
先在上面的工作台试试 Nano Banana 2.1，再通过 Nano Banana 2.1 API 把同一个模型接进你的产品。