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

> Nano Banana 2 的 API key 免费创建，要买的是预付额度：最低 $5，每张 $0.045–$0.151，无免费层；中国大陆与港澳不在官方可用地区，转卖的 key 别买。

- Source: https://www.aifreeapi.com/zh/posts/nano-banana2-api-key-purchase
- Language: zh
- Published: 2025-12-11
- Updated: 2026-09-25
- Publisher: AI Free API (https://www.aifreeapi.com)

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](https://aistudio.google.com/apikey) 里免费创建，真正要付钱的是 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、成品号和代注册账号不要买。

| 你的情况 | 可以走的路线 | 第一笔钱 | 先确认什么 |
|---|---|---|---|
| 人在可用地区，自己能完成 Google 结算 | AI Studio 创建 key + 预付额度 | 最低 $5 | 结算页面显示的本地区最低额 |
| 团队已有 Google Cloud 企业账号 | Google Cloud 的 Gemini Enterprise Agent Platform | 按 Google Cloud 账单 | 项目区域与服务账号权限 |
| 不在可用地区，公司能通过网关的准入审核 | 第三方网关，用它的令牌调用 | 网关预付余额 | 准入条件、按次价、失败怎么扣费 |
| 只想先看几张效果 | 浏览器试用页 | 试用额度用完为止 | 试用名额和之后需要什么凭据 |

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

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

| 你拿到的 | 归谁所有 | 钱付给谁 | 会怎样失效 |
|---|---|---|---|
| 自己在 AI Studio 创建的 API key | 你自己的 Google Cloud 项目 | Google，预付到你的结算账号 | 余额为 0 时返回 `402`；你可以随时轮换 |
| 第三方网关的令牌 | 你在网关平台上的账号 | 网关平台 | 按网关的余额、价格和服务条款 |
| 别人转卖给你的 Google key | 卖家的项目 | 卖家，Google 那边你没有账户 | 卖家轮换、项目被停用、泄露封禁、standard key 被拒 |
| 成品号、共享账号、代注册账号 | 名义上归别人 | 卖家 | 账号被收回或被风控，余额和数据都不在你手里 |

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

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

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

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

满足之后，流程按 Google 的 [结算文档](https://ai.google.dev/gemini-api/docs/billing?hl=zh-cn) 走：

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

![官方路线四步示意：在 AI Studio 免费创建默认为 auth key 的密钥，点 Set up billing 关联结算账号，预付 $5 起且 12 个月后过期，再用 x-goog-api-key 请求一张 1K 图验证；底部提示余额为 0 时同一结算账号下所有 key 返回 402](https://www.aifreeapi.com/posts/zh/nano-banana2-api-key-purchase/img/official-steps.webp)

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

- 预付额度 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 怎么付费：官方额度、使用等级与国内选择](/zh/posts/gemini-api-key-tiers)。

### 2026 年起新建的是 auth key

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

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

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

官方价格按 token 计，但 [价格页](https://ai.google.dev/gemini-api/docs/pricing) 已经把图片输出折算成每张价格：图片输出 $60 / 百万 token，1K 图消耗 1,120 个 token，所以是 $0.067 一张。用最低预付额度 $5 去除每张的输出价，向下取整：

| 输出分辨率 | 标准每张 | $5 约可出 | Batch 每张 | $5 约可出（Batch） |
|---|---|---|---|---|
| 0.5K（512px） | $0.045 | 111 张 | $0.022 | 227 张 |
| 1K | $0.067 | 74 张 | $0.034 | 147 张 |
| 2K | $0.101 | 49 张 | $0.050 | 100 张 |
| 4K | $0.151 | 33 张 | $0.076 | 65 张 |

计算口径：张数 = 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 成本](/zh/posts/gemini-flash-image-generation-pricing)；思考级别对单次成本和等待时间的影响，见 [Nano Banana 2 思考级别怎么选](/zh/posts/nano-banana-2-thinking-level)。如果你其实需要的是 Pro，价格另算，见 [Nano Banana Pro API 价格：1K、2K、4K 与批量成本](/zh/posts/nano-banana-pro-pricing)，两者怎么选见 [Nano Banana 2 vs Pro 怎么选](/zh/posts/nano-banana-2-vs-nano-banana-pro)。

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

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

![凭据路线分流图：所在地在可用地区就在 AI Studio 自建 key 并预付额度；不在则看是否已有 Google Cloud 企业账号，可用 Agent Platform；再看公司能否通过第三方网关准入，使用网关自己的令牌；都不满足时不要转去购买 key、成品号或代注册](https://www.aifreeapi.com/posts/zh/nano-banana2-api-key-purchase/img/route-flow.webp)

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

### Google Cloud 企业账号：Agent Platform

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

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

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

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

以 [老张API（laozhang.ai）](https://docs.laozhang.ai/api-capabilities/nano-banana-image) 为例，它的公开文档写明了这些条件：

- 由新加坡公司 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 标准 | Google Batch | 老张API 按次 |
|---|---|---|---|
| 0.5K | $0.045 | $0.022 | $0.055 |
| 1K | $0.067 | $0.034 | $0.055 |
| 2K | $0.101 | $0.050 | $0.055 |
| 4K | $0.151 | $0.076 | $0.055 |

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）](https://yingtu.ai/) 的网页工作台。它调用的是同一个老张API端点：用 Google 账号登录的新用户可领 $0.1 试用额度，限前 500 名、30 天有效，大约够出 1–4 张图，不需要绑卡。试用额度用完后，需要自己的老张API令牌才能继续，也就是回到上一节的白名单和 Gmail 条件，它不是免 key 的长期路线。页面上每张图都是一次独立调用，按 $0.055 一张计，失败的格子不会自动重试。

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

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

| 常见说法 | 实际是什么 | 为什么不要买 | 改做什么 |
|---|---|---|---|
| 淘宝、闲鱼上的"Gemini API Key""Nano Banana key" | 卖家项目下的一串 key | 项目归卖家，随时可被轮换或停用；你看不到余额和账单；standard key 在 2026 年 9 月起被拒，只有所有者能迁移 | 在自己的项目里免费创建 key |
| 成品号、共享账号 | 别人注册好的 Google 账号 | 账号和结算不归你，被收回时余额、项目、生成记录一起没了 | 用自己的账号开结算，或用网关的个人令牌 |
| 代注册、代充 | 用他人身份或支付信息开通 | 结算信息不属于你，出问题无法申诉，也可能违反地区条款 | 确认自己是否满足地区和付款条件 |
| 换 IP + 虚拟卡的教程 | 伪装成可用地区用户 | 外卡和 IP 不改变地区资格，违反附加条款，账号和余额可能一起作废 | 选择符合你所在地条件的路线 |

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

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

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

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

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

```python
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 怎么处理](/zh/posts/nano-banana2-api-error-codes)。

用网关令牌测试时，同一段代码只改两处：把 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 免费吗？](/zh/posts/nano-banana-2-free)。

### 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 或正规网关的令牌。