Nano Banana 2 API Key 购买：官方额度、单价与地区

Nano Banana 2 在 Gemini API 里的正式名称是 Gemini 3.1 Flash Image，模型 ID 为 gemini-3.1-flash-image（2026 年 5 月 28 日转为正式版）。它不是 Nano Banana Pro，后者对应 Gemini 3 Pro Image，价格也不同。

Google 不卖 API key。key 在 Google AI Studio 里免费创建，真正要付钱的是 key 所属项目的结算账号：新用户默认是预付款，最低预付 $5（或当地货币等值，以结算页面显示为准），额度 12 个月后过期，一般不退。Nano Banana 2 在 API 里没有免费层，按输出分辨率计费，截至 2026 年 9 月 25 日，每张 $0.045（0.5K）到 $0.151（4K），1K 是 $0.067。只算图片输出，$5 大约能出 74 张 1K 图或 33 张 4K 图。

能不能走这条官方路线，先看所在地：Google AI Studio 和 Gemini API 的可用地区列表里没有中国大陆、香港和澳门，条款要求在可用地区内访问。第三方 API 网关给你的是它自己平台的令牌，不是 Google key；淘宝、闲鱼上的 Google key、成品号和代注册账号不要买。

买 Nano Banana 2 的 key，付钱买到的到底是什么

"买 Nano Banana 2 的 key"可能指四样完全不同的东西：

前两种是正常的凭据：一种直接对 Google，一种对一个你能核验的服务商。后两种用的是别人的凭据，为什么不要买，下文单独列出。

官方路线：在 AI Studio 创建 key 并开通付费、充值

开始前确认三个前提，任何一个不满足，后面的步骤都会卡住或违反条款：

• 你访问服务时所在的国家或地区在 可用地区列表 里。列表包括台湾、日本、新加坡、美国等，不包括中国大陆、香港和澳门。
• 年满 18 岁，并且是开发者为专业或商业用途使用（见 Gemini API 附加条款）。
• 有结算页面接受的付款方式。首次开通结算时要选择国家、填写联系信息和付款方式；有一张外卡不会改变地区资格。

满足之后，流程按 Google 的 结算文档 走：

1. 打开 AI Studio 的 API 密钥页，接受服务条款。新用户会自动得到一个默认的 Google Cloud 项目和一把 API key；已有 Google Cloud 账号的人需要先导入现有项目。创建 key 不收费。
2. 在项目这一行的结算层级列点"Set up billing"，关联一个结算账号。以前没开过 Google 结算账号，会先让你选择国家、同意条款，再填联系信息和付款方式。
3. 按提示预付。新用户默认是预付款（Prepay），最低 $5 或当地等值；页面会显示你所在地区和层级要求的实际最低额，账户余额最多 $5,000。部分账号会被分到后付费（Postpay），或让你二选一。
4. 可选：在 AI Studio 的结算页设置自动充值，并给它设一个每月自动扣款上限，防止连续充值带来意外支出。
5. 回到密钥页，确认项目的层级显示为已付费，再用下文的最小请求测试一次。

几条和钱有关、容易被忽略的规则：

• 预付额度 12 个月后过期，不退款；只有符合条件、主动从预付款切换到后付费时，剩余余额才会原路退回。关闭结算账号的话，余额作废。
• 余额降到 $0 时，这个结算账号下所有项目的所有 key 同时停用，请求返回 402 Payment Required，直到你再充值。计费有大约 10 分钟延迟，Batch 这类长任务可能在停下之前多扣一点。
• 2026 年 3 月 2 日之后开的 Google Cloud 账号，新用户那 $300 欢迎金不能用于 Gemini API 和 AI Studio。
• 第一档付费层级（Tier 1）每个结算账号每月最多消费 $250；累计付款满 $100、且距首次付款满 3 天后升到 Tier 2（月上限 $2,000）。达到上限后，所有关联项目会暂停到下个月 1 号。各层级的升级条件和密钥安全设置见 Gemini API Key 怎么付费：官方额度、使用等级与国内选择。

2026 年起新建的是 auth key

从 2026 年 5 月 28 日起，AI Studio 新建的 key 默认是授权密钥（auth key）：绑定一个服务账号，默认只允许调用 Gemini API，被检测到泄露时会很快被停用。旧式的 standard key 里，没有加任何限制的已经被拒绝；Google 的 API 密钥文档 写明 2026 年 9 月起拒绝所有 standard key，没有给出具体日期。

如果你手上是 2026 年 5 月 28 日之前在自己项目里建的 standard key，现在就按文档迁移到 auth key。迁移只能由项目所有者完成，这也是买来的旧 key 这个月可能突然不能用的原因之一。

Nano Banana 2 API 价格：第一笔 $5 能出多少张图

官方价格按 token 计，但 价格页 已经把图片输出折算成每张价格：图片输出 $60 / 百万 token，1K 图消耗 1,120 个 token，所以是 $0.067 一张。用最低预付额度 $5 去除每张的输出价，向下取整：

计算口径：张数 = floor($5 ÷ 每张图片输出价)，美元，Google 付费层级列表价。这是上限，不是实际额度：提示词和参考图的输入（$0.50 / 百万 token）、思考与文字输出（$3 / 百万 token）、使用 Google 搜索建立依据超出每月 5,000 次免费后的费用（$14 / 千次）、税费和重试都会让实际张数变少。Batch 是异步提交，适合离线批量，不适合用户在界面上等图。

同样的算法放大到 Tier 1 的月上限 $250：只算输出，约 3,731 张 1K 标准图，或约 1,655 张 4K 标准图。月用量超过这个量级，就需要先规划层级升级。

逐档价格、Batch 什么时候划算，见 Nano Banana 2 API 价格：Google 官方费率与 Batch 成本；思考级别对单次成本和等待时间的影响，见 Nano Banana 2 思考级别怎么选。如果你其实需要的是 Pro，价格另算，见 Nano Banana Pro API 价格：1K、2K、4K 与批量成本，两者怎么选见 Nano Banana 2 vs Pro 怎么选。

不在可用地区时还有哪些路线

中国大陆、香港和澳门的读者，直接在 AI Studio 开通不符合 Gemini API 的地区条款。换 IP、借用他人所在地身份、配一张虚拟卡，都不会让你变成可用地区的用户，这类做法也可能让账号和余额一起作废。国内能否使用 Nano Banana 2、各条路线的前提，另有一篇 国内能否使用 Nano Banana 2 专门说明。

与"买 key"直接相关的，是下面三种凭据来源。

Google Cloud 企业账号：Agent Platform

可用地区页给不在列表内的用户指了另一个入口：Google Cloud 上的 Gemini Enterprise Agent Platform（价格页仍在 Vertex AI 栏目下）。gemini-3.1-flash-image 在那里也是正式版，认证用 Google Cloud 服务账号而不是 AI Studio 的 key。价格 在 global 端点与 AI Studio 相同（1K $0.067、4K $0.15），美国或欧盟区域端点贵 10%，并且只对返回 200 的请求计费。

这条路线适合已经有 Google Cloud 结算账号和项目的团队。中国大陆注册的公司能否开通，公开文档没有说明，要以 Google Cloud 的开户结果为准，不能把它当成现成的国内方案。

第三方 API 网关：买的是网关令牌

网关的模式是：你在网关平台注册、预付余额、创建它的令牌，请求发到网关的域名，由网关去调用上游模型。你拿到的始终是网关的令牌，账单、价格、失败计费和数据处理都按网关的规则。网关上游用什么账号和渠道，从外部无法核验，所以选网关看的是它公开写明的条件，而不是"官方渠道""国内直连"之类的宣传语。

以 老张API（laozhang.ai） 为例，它的公开文档写明了这些条件：

• 由新加坡公司 YingTu Technology Pte. Ltd. 运营，面向企业与开发者；注册和服务以企业白名单审核为准，只支持 Gmail 邮箱注册，企业开通需邮件申请。调用结果的使用与合规由使用方负责。
• gemini-3.1-flash-image 按次计费 $0.055（2026 年 9 月 24 日的价格配置，调用前以其价格表为准），不随分辨率、思考级别、参考图数量或生成/编辑变化。$5 余额约可调用 90 次。
• HTTP 200 但没有图片（包括被上游安全策略拦截）按一次扣费；客户端超时可能已经扣费，重试前要先查调用日志；返回 429、503 且没进入生成的请求通常不扣费。
• 要设置分辨率和宽高比，需用 Gemini 原生格式（/v1beta/models/{model}:generateContent）；OpenAI 兼容格式的文生图固定输出 1024×1024。
• 文档没有声明中国大陆可用，也没有列出具体支付方式，这两点以其控制台为准。

和官方比，按次价的差别取决于你出什么尺寸：

Google 列的是每张图片输出价，另按输入和思考 token 计费；网关是一次调用一个价。出 1K–4K 的交互式请求，按次价更低；只出 0.5K，或者能用 Batch 跑 1K、2K，官方更便宜。失败的算法也不同：Google 对 400 和 500 失败不收 token 费，200 但没有图片的情况怎么计费，Google 没有写明；这家网关则明确对 200 无图扣费。所以批量调用前，先在客户端检查提示词里有没有明确要求出图、有没有容易被拦截的内容。

其他网关同样按这几项核对：运营主体、上游来源、分辨率是否可选、失败和超时怎么扣费、余额能否退。旧教程里出现过的几家至今仍在运营，但公开页面都没有写明上游来源和失败计费。例如 GrsAI 页面把 nano-banana-2 标为 ¥0.06 / 次，按 1 美元约合 7.1 元估算约 $0.008，只有 Google 1K 列表价的八分之一左右，页面没有说明对应的模型路线、分辨率和失败计费。价格明显低于官方列表价时，先问清楚这些再充值。

先在浏览器里试几张

还没决定要不要接 API，只想看 Nano Banana 2 的出图效果，可以用 YingTu（yingtu.ai） 的网页工作台。它调用的是同一个老张API端点：用 Google 账号登录的新用户可领 $0.1 试用额度，限前 500 名、30 天有效，大约够出 1–4 张图，不需要绑卡。试用额度用完后，需要自己的老张API令牌才能继续，也就是回到上一节的白名单和 Gmail 条件，它不是免 key 的长期路线。页面上每张图都是一次独立调用，按 $0.055 一张计，失败的格子不会自动重试。

转卖的 key、成品号和代充不要买

下面几类都是用别人的凭据，便宜的价格掩盖的是随时失效和无处追责：

Google 的 API 条款 要求开发者自己保管凭据、不得把 API 转授权给第三方使用；auth key 被检测到泄露时会很快被停用。一把在多个买家之间流转的 key，本身就是泄露。

拿到凭据后，用一次最小请求确认能出图

不要用文字模型测试 key：Nano Banana 2 没有免费层，文字请求成功不代表图片请求能扣费出图。下面这段 Python 直接请求 gemini-3.1-flash-image，出一张 1K 图（按列表价，输出约 $0.067，另有少量输入和思考费用），成功时把图片保存到当前目录。

先把 key 放进环境变量，不要写进代码或提交到 Git：

export GEMINI_API_KEY="你的 API key"
python -m pip install requests

import base64
import os

import requests

MODEL = "gemini-3.1-flash-image"
URL = f"https://generativelanguage.googleapis.com/v1beta/models/{MODEL}:generateContent"

resp = requests.post(
    URL,
    headers={
        "x-goog-api-key": os.environ["GEMINI_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "contents": [{"parts": [{"text": "生成一张图片：白色背景上的一根香蕉，扁平插画风格"}]}],
        "generationConfig": {
            "responseModalities": ["TEXT", "IMAGE"],
            "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"},
        },
    },
    timeout=120,
)

print("HTTP", resp.status_code)
data = resp.json()
if resp.status_code != 200:
    print(data.get("error", data))
    raise SystemExit(1)

candidate = (data.get("candidates") or [{}])[0]
for part in candidate.get("content", {}).get("parts", []):
    inline = part.get("inlineData")
    if inline and inline.get("mimeType", "").startswith("image/"):
        ext = inline["mimeType"].split("/")[1]
        with open(f"nb2-test.{ext}", "wb") as f:
            f.write(base64.b64decode(inline["data"]))
        print(f"已保存 nb2-test.{ext}", data.get("usageMetadata"))
        break
else:
    print("HTTP 200 但没有图片：", candidate.get("finishReason"), data.get("promptFeedback"))

怎么判断结果：

• 打印"已保存"并生成了图片文件：key、结算和模型 ID 都没问题。usageMetadata 里的 token 数可以和结算页的扣费对照。
• 402：预付余额为 0 或还没完成预付。
• 404，提示找不到模型：模型名写错，或还在用 2026 年 6 月 25 日已停用的 gemini-3.1-flash-image-preview。
• 400，提示所在地区不支持：调用发起地不在可用地区，重试无效。
• 400，参数错误：常见是把 imageSize 写成了小写 1k，必须用大写 1K、2K、4K。
• 200 但没有图片：看打印出的 finishReason，通常要改提示词或参考图，不要原样重试。

这里用的是 generateContent 接口，Google 仍完整支持它；新项目也可以改用官方推荐的 Interactions API，报错写法有所不同。各类报错的完整处理，见 Nano Banana 2 API 报错：429、503、NO_IMAGE 怎么处理。

用网关令牌测试时，同一段代码只改两处：把 URL 的主机换成网关文档给出的地址（老张API是 https://api.laozhang.ai ），把请求头换成 Authorization: Bearer 你的令牌。网关按次扣费，这一次测试同样会计一次调用。

上线时，key 只放在服务器端：不要写进网页或 App 的前端代码，前端请求先经过你自己的后端再调用 API。

常见问题

Nano Banana 2 的 API 有免费额度吗？

没有。Google 价格页上 Nano Banana 2 的免费层输入和输出都标为不可用，调用 API 必须先开通付费。Gemini 应用里的免费使用和 API 是两回事，想先免费看效果，见 Nano Banana 2 免费吗？。

Nano Banana 2 是 $0.134 一张、每天免费 250 次吗？

不是。$0.134 是 Nano Banana Pro（Gemini 3 Pro Image）的 1K/2K 价格，Nano Banana 2 的 1K 是 $0.067；Nano Banana 2 的 API 没有免费层。旧代码里的 nano-banana-pro 也不是 Google 的模型 ID，Google 那边 Pro 的 ID 是 gemini-3-pro-image。

新开 Google Cloud 账号送的 $300 能用来付 Nano Banana 2 吗？

2026 年 3 月 2 日之后开的账号不能。那笔欢迎金只能用在 Google Cloud 的其他产品上，Gemini API 要用预付额度付款。

Gemini API 的预付额度用不完会怎样？

预付额度买入 12 个月后过期，过期作废，一般不退。第一笔先按最低额度买，跑通流程、看清每张图的实际扣费后，再决定是否开自动充值。

买来的 key 本来能用，这个月突然失效了，是被封了吗？

可能是被卖家轮换、项目被停用或判定泄露，也可能是 standard key 被拒绝：Google 写明 2026 年 9 月起不再接受 standard key，只有项目所有者能迁移到 auth key。无论哪种原因，你都没法自己修好，只能换成自己项目里的 key 或正规网关的令牌。