Nano Banana API接入教程:价格和代码示例
想把 Nano Banana 接进自己的产品或脚本,这页讲清两条路怎么选、每张多少钱、代码怎么写。下面的框可以先用同一个模型试效果,满意了再接 Nano Banana API。
先看你该接哪个 Nano Banana API
Nano Banana API 有两条路:谷歌官方的 Gemini API,或者本站的图片接口。已经有谷歌云账号和结算方式,用官方最直接;想用中文文档、按积分付费、同一个 Key 调多个模型,可以看本站。下面把差别列清楚。

官方和本站有什么不同
| 对比项 | 谷歌官方 Gemini API | 本站图片接口 |
|---|---|---|
| 调用格式 | 谷歌官方格式和 SDK | 本站格式,提交任务后查询结果;不兼容 OpenAI 和谷歌 SDK |
| 付费方式 | 谷歌账号结算,按美元计费 | 先买积分,按张扣 |
| 能调的模型 | 谷歌自家模型 | Nano Banana 系列,加上 GPT Image、Seedream 等图片模型 |
| 调用门槛 | 按谷歌要求开通,图片输出没有免费档 | 账号有过付费才能调用,只有赠送积分不行 |
| 失败怎么算 | 以谷歌规则为准 | 失败、超时、审核没过都不扣积分 |
| 适合谁 | 已在用谷歌云,要官方服务条款 | 想用中文文档、一个 Key 切换多个模型 |
本站是第三方服务,不是谷歌官方。官方内容来自谷歌文档,2026 年 11 月 2 日核对,以谷歌最新公布为准。
Nano Banana API 每张多少钱
本站的 Nano Banana API 按积分算,每张扣的积分固定,积分单价要看你买的是哪一档。下面的价格按 2026 年 11 月 3 日的配置算,打开联网搜索的话每张再加 1 积分。
| 模型 ID | 1K | 2K | 4K | 谷歌官方 1K 价 |
|---|---|---|---|---|
| nano-banana-2 | 2 积分 | 2 积分 | 3 积分 | 0.067 美元 |
| nano-banana-pro | 2 积分 | 2 积分 | 4 积分 | 0.134 美元 |
| nano-banana-2.1 | 4 积分 | 4 积分 | 5 积分 | 0.0336 美元 |
| nano-banana-2-official(加速) | 4 积分 | 4 积分 | 5 积分 | 同 Nano Banana 2 |
| nano-banana-pro-official(加速) | 3 积分 | 4 积分 | 6 积分 | 同 Nano Banana Pro |
换算成人民币
| 积分包 | 价格 | 每积分约 | Nano Banana 2 的 1K 图每张约 |
|---|---|---|---|
| 入门 100 积分 | ¥58 | ¥0.58 | ¥1.16 |
| 标准 240 积分 | ¥98 | ¥0.41 | ¥0.82 |
| 高级 2,000 积分 | ¥399 | ¥0.20 | ¥0.40 |
| VVIP 8,000 积分 | ¥999 | ¥0.125 | ¥0.25 |
只算一次性积分包,月付、年付和团队版看价格页。用量小时,官方单价可能更低;本站的优势主要是中文文档、按积分付费和一个 Key 切换多模型,下单前请按自己的用量算一遍。
用代码生成一张图
下面的 Nano Banana API 例子都是本站接口。流程分两步:先提交任务拿到 id,再用 id 查询结果。官方接口请看谷歌图片生成文档。
第 1 步:提交任务
curl -X POST https://www.nano-banana.cn/api/ai/generate/ \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"mediaType": "image",
"model": "nano-banana-2",
"prompt": "一杯冰拿铁放在木桌上,清晨窗边的柔光",
"scene": "text-to-image",
"options": { "aspectRatio": "1:1", "resolution": "1K" }
}'
# 返回
# { "code": 0, "message": "ok", "data": { "id": "3f2a1b4c-...", "status": "queuing" } }第 2 步:查询结果
一张图通常要 20 到 60 秒,每隔约 10 秒查询一次就够了。本站接口不支持回调(webhook),只能用查询的方式拿结果。
curl -X POST https://www.nano-banana.cn/api/ai/query/ \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{ "taskId": "3f2a1b4c-..." }'
# 成功时返回
# { "code": 0, "data": { "id": "...", "status": "success", "outputImages": ["https://..."] } }Python 完整示例
import os, time, requests
BASE = "https://www.nano-banana.cn"
HEADERS = {"Authorization": f"Bearer {os.environ['NANO_BANANA_KEY']}"}
task = requests.post(f"{BASE}/api/ai/generate/", headers=HEADERS, json={
"mediaType": "image",
"model": "nano-banana-pro",
"prompt": "咖啡新品海报,顶部大标题写:秋日第一杯",
"scene": "text-to-image",
"options": {"aspectRatio": "3:4", "resolution": "2K"},
}, timeout=60).json()
task_id = task["data"]["id"]
while True:
time.sleep(10)
data = requests.post(f"{BASE}/api/ai/query/", headers=HEADERS,
json={"taskId": task_id}, timeout=60).json()["data"]
if data["status"] == "success":
print(data["outputImages"][0])
break
if data["status"] == "failed":
raise RuntimeError(data)上传参考图再改图
用 Nano Banana API 改图要先把图片传上来,拿到地址后放进 options.image_urls,并把 scene 改成 image-to-image。
curl -X POST https://www.nano-banana.cn/api/storage/upload-image \
-H "Authorization: Bearer sk-your-api-key" \
-F "files=@./reference.png"
# 返回的 data.urls 传给生图请求:
# "scene": "image-to-image",
# "options": { "image_urls": ["上一步返回的图片地址"], "resolution": "1K" }常用参数
| 参数 | 必填 | 说明 |
|---|---|---|
| mediaType | 是 | 生图固定写 image |
| model | 是 | 模型 ID,见上面的价格表 |
| prompt | 是 | 图片描述,可以写中文 |
| scene | 否 | text-to-image 文生图,image-to-image 图生图 |
| options.aspectRatio | 否 | 比例,如 1:1、3:4、16:9 |
| options.resolution | 否 | 分辨率,如 1K、2K、4K |
| options.image_urls | 否 | 参考图地址数组,改图时用 |
| options.web_search | 否 | 打开联网搜索,每张加 1 积分 |
Nano Banana API 的完整参数和错误说明以 API 文档页 为准。
接好之后,出图质量看提示词
Nano Banana API 的提示词写法和网页上一样。可以先在本页顶部的框里调好,再放进代码。案例可以看 Nano Banana提示词大全,选模型可以看 Nano Banana Pro 和 2 对比。
三步接入
以本站的 Nano Banana API 为例。
买积分并创建 Key
购买任意积分包后,到 API 页面创建 Key。
提交生图任务
用 Key 调用 generate 接口,记下返回的任务 id。
查询并保存图片
每隔约 10 秒调用 query 接口,成功后从 outputImages 取图片地址。
Nano Banana API 常见问题
本站内容按当前配置,2026 年 11 月 3 日核对;谷歌内容以官方文档为准。
谷歌接口的图片输出没有免费档。本站注册赠送的积分只能在网页上用,账号有过付费才能调用接口。
不能。本站接口是自己的格式,要按上面的例子写请求。迁移时主要改提交和查询这两处。
不会。生成失败、超时或审核没过都不扣积分。
支持。先上传图片拿到地址,放进 options.image_urls,scene 写 image-to-image。
把 model 改成 nano-banana-pro 就行,其他参数不变。要 4K 就把 options.resolution 改成 4K,每张 4 积分。
支持。充值后可以在控制台申请发票,具体说明在 API 文档页的常见问题里。