Nano Banana API接入教程:价格和代码示例

想把 Nano Banana 接进自己的产品或脚本,这页讲清两条路怎么选、每张多少钱、代码怎么写。下面的框可以先用同一个模型试效果,满意了再接 Nano Banana API。

先看你该接哪个 Nano Banana API

Nano Banana API 有两条路:谷歌官方的 Gemini API,或者本站的图片接口。已经有谷歌云账号和结算方式,用官方最直接;想用中文文档、按积分付费、同一个 Key 调多个模型,可以看本站。下面把差别列清楚。

本站模型选择菜单,列出 Nano Banana 2 和 Nano Banana Pro 等模型及积分

官方和本站有什么不同

对比项谷歌官方 Gemini API本站图片接口
调用格式谷歌官方格式和 SDK本站格式,提交任务后查询结果;不兼容 OpenAI 和谷歌 SDK
付费方式谷歌账号结算,按美元计费先买积分,按张扣
能调的模型谷歌自家模型Nano Banana 系列,加上 GPT Image、Seedream 等图片模型
调用门槛按谷歌要求开通,图片输出没有免费档账号有过付费才能调用,只有赠送积分不行
失败怎么算以谷歌规则为准失败、超时、审核没过都不扣积分
适合谁已在用谷歌云,要官方服务条款想用中文文档、一个 Key 切换多个模型

本站是第三方服务,不是谷歌官方。官方内容来自谷歌文档,2026 年 11 月 2 日核对,以谷歌最新公布为准。

Nano Banana API 每张多少钱

本站的 Nano Banana API 按积分算,每张扣的积分固定,积分单价要看你买的是哪一档。下面的价格按 2026 年 11 月 3 日的配置算,打开联网搜索的话每张再加 1 积分。

每张扣多少积分
模型 ID1K2K4K谷歌官方 1K 价
nano-banana-22 积分2 积分3 积分0.067 美元
nano-banana-pro2 积分2 积分4 积分0.134 美元
nano-banana-2.14 积分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 Key 怎么拿

  • 谷歌官方:在 Google AI Studio 创建 Key,并按要求开通结算。
  • 本站:注册账号,购买积分,再到 API 页面 创建以 sk- 开头的 Key。
  • 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 取图片地址。

准备好接入了吗

接口按张扣积分,失败不扣。查看完整参数并创建 Key。

Nano Banana API 常见问题

本站内容按当前配置,2026 年 11 月 3 日核对;谷歌内容以官方文档为准。

谷歌接口的图片输出没有免费档。本站注册赠送的积分只能在网页上用,账号有过付费才能调用接口。


不能。本站接口是自己的格式,要按上面的例子写请求。迁移时主要改提交和查询这两处。


不会。生成失败、超时或审核没过都不扣积分。


支持。先上传图片拿到地址,放进 options.image_urls,scene 写 image-to-image。


把 model 改成 nano-banana-pro 就行,其他参数不变。要 4K 就把 options.resolution 改成 4K,每张 4 积分。


支持。充值后可以在控制台申请发票,具体说明在 API 文档页的常见问题里。