如何获取 Nano Banana Pro API Key:免费建 key,开通计费才能出图
Nano Banana Pro API Key 在 AI Studio 免费创建,但图片模型没有免费层:开通计费(新账号预付,最少 $5)才能出图,Pro 每张 $0.134 起。
文章目录

Nano Banana Pro 的 API Key 在 Google AI Studio 的 API Keys 页面创建,key 本身不收费。但截至 2026 年 10 月 10 日,Gemini API 定价页上所有图片模型的免费层一栏都是“Not available”:项目必须先关联结算账号,新账号默认走预付,最少充 $5,之后才能生成第一张图。Google Cloud 新用户的 $300 赠金也不能用来付这笔钱。
调用时模型 ID 写 gemini-3-pro-image。旧的 gemini-3-pro-image-preview 已在 2026 年 6 月 25 日停用(Gemini API 弃用页),代码里还写着它的请求不会再成功。官方价格是 1K/2K 每张 $0.134、4K 每张 $0.24。如果图里的文字不要求一字不差,同一个 key 也能调 Nano Banana 2.1(gemini-nano-banana-2.1),1K 每张 $0.0336。另外,Gemini API 的支持地区列表里没有中国大陆、香港和澳门,下面的步骤只适用于列表内的地区。
2026 年 10 月的变化:模型 ID、新 key 类型和预付计费
如果你照着 2026 年上半年的步骤操作却卡住了,多半是下面某一项已经变了:
| 事项 | 截至 2026 年 10 月 10 日的规则 | 还按旧做法会怎样 |
|---|---|---|
| 模型 ID | gemini-3-pro-image(正式版) | 仍写 gemini-3-pro-image-preview:它已于 6 月 25 日停用,请求失败 |
| 新建的 key | 2026 年 5 月 28 日起,AI Studio 新建的 key 一律是 auth key | 旧的标准 key 没加任何限制:请求被 Gemini API 拒绝 |
| 开通计费 | 在 AI Studio 点 Set up billing,新账号默认预付,最少 $5 | 只建 key 不开计费:图片请求返回 429,额度显示为 0 |
| 已在用后付的账号 | Google 正把 Gemini API 账号从后付迁到预付,截止日期写在各账号收到的通知里;Impress Watch 报道的日期是 2026 年 10 月 12 日 | 不切换、不买额度:到期后服务中断 |
| 升级层级 | Tier 2 的条件是已付 $100,且首次成功付款后满 3 天 | 停在 Tier 1:每月花费上限 $250,每 10 分钟 $10 |
| Google Cloud $300 赠金 | 不能用于 Gemini API 和 AI Studio | 指望赠金抵扣:费用照样从预付余额里扣 |
| 更便宜的选择 | Nano Banana 2.1(gemini-nano-banana-2.1),10 月 6 日正式发布,1K 每张 $0.0336 | 继续用 gemini-2.5-flash-image:它已列入停用计划 |
模型 ID、key 类型和计费三项最常直接导致第一次调用失败,后面几节按操作顺序逐项说明。动手之前,先把 key 到底免不免费说清楚。
Nano Banana Pro API Key 免费吗:建 key 免费,出图没有免费层
key 免费,用它出图要付费。按 Gemini API 的 API Key 文档,在 AI Studio 创建 key 不收费,也不要求先绑结算账号;但截至 2026 年 10 月 10 日,定价页上 Nano Banana Pro、Nano Banana 2.1、Nano Banana 2 和 Nano Banana 2 Lite 的免费层都是“Not available”。没开计费的项目拿这个 key 调图片模型,只会收到 429。开通计费后新账号默认预付,最少充 $5,Pro 每张 1K/2K 图扣 $0.134,4K 扣 $0.24,走 Batch 减半。
常被当成“免费额度”的几样东西,截至 2026 年 10 月 10 日的实际情况如下:
| 说法 | 实际情况 |
|---|---|
| Google Cloud 新用户的 $300 赠金 | 从 2026 年 3 月起,Gemini API 费用明确不在 $300 免费试用的覆盖范围内;Google Cloud 欢迎赠金也不能付 AI Studio 的用量 |
| AI Studio 可以免费用 | AI Studio 网页本身不收费,但 Playground 里的图片模型要有 Google AI 订阅或关联付费 API key 才能用;截至 2026 年 10 月 5 日,Playground 对 Nano Banana 2 的提示是“only available in the Playground via a Google AI Plan or an API key” |
| 订阅 Google AI Pro、Ultra 就有 API 额度 | 订阅只提高 AI Studio 网页里的额度;直接调用 Gemini API 另外计费 |
| 网上流传的“免费用户每天 N 次请求” | Google 没有公布免费层的每日次数表;这类数字即使对文字模型成立,也不适用于图片模型,因为图片模型没有免费层 |
| 第三方页面的“免费 Nano Banana Pro API” | 拿到的是对方平台的 key 和余额,不是 Google 的 key;条款、数据处理和实际调用的模型由对方决定 |
所以“免费”只到建 key 为止。建好以后,可以先用下一节里那个不出图、不计费的请求确认 key 有效,再决定要不要充值。Gemini 图片模型整体的免费情况见 Gemini 图片生成 API 免费吗:已无免费层,标准价最低每张 $0.0336;预付、后付和“无积分”状态的区别见 Gemini API 计费层级详解:后付费转预付费、“无积分”与 402 排查。
在 AI Studio 创建 API Key:2026 年 5 月 28 日起默认是 auth key
Gemini API 的 API Key 文档(2026 年 10 月 6 日更新)写明:新用户第一次进入 AI Studio 时,系统会自动建好一个 Google Cloud 项目和一个 key。所以很多人登录后就能在列表里看到现成的 key,不必从零创建。
完整流程如下:
- 登录。 打开 aistudio.google.com/apikey,用 Google 账号登录;普通 Gmail 账号即可,不需要先单独开通 Google Cloud。第一次使用会要求接受服务条款。
- 创建或选用 key。 已有默认 key 就直接用;需要新 key 时点 Create API key,在对话框里选一个项目或新建项目,也可以导入已有的 Google Cloud 项目。每个 key 都属于一个项目,计费、配额和用量统计都按项目走。
- 看 Key Type 一列。 2026 年 5 月 28 日之后新建的 key 是 auth key,它直接绑定一个 Google Cloud 服务账号,请求以这个服务账号的身份处理,权限可以细分,泄露后 Google 的处置也更快。列表里标着 Standard 的是旧式标准 key:加了限制的仍可使用;带 Unrestricted 标签的会被 Gemini API 拒绝,只给 Gemini 用的话,点 Restrict to Gemini API only,或者干脆新建一个 auth key。
- 把 key 放进环境变量。 设置
GEMINI_API_KEY或GOOGLE_API_KEY,官方 SDK 会自动读取;两个都设了时优先用GOOGLE_API_KEY。不要把 key 写进代码或提交到 Git。 - 在同一张表里开通计费。 项目的 Billing Tier 一列显示 Set up billing 时,说明它还在免费层,调用图片模型会被拒绝,开通方法见下一节。

拿到 key 后,可以先用一个不出图、不计费的请求确认 key 有效:
export GEMINI_API_KEY="你的 key"
curl -s "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image" \
-H "x-goog-api-key: $GEMINI_API_KEY"key 有效时会返回这个模型的名称和参数。截至 2026 年 10 月 8 日,key 无效时返回的是下面这段:
{
"error": {
"code": 400,
"message": "API key not valid. Please pass a valid API key.",
"status": "INVALID_ARGUMENT"
}
}完整响应的 details 里还带有 "reason": "API_KEY_INVALID"。请求里完全没带 key 时返回的是 403 PERMISSION_DENIED。这一步通过只说明 key 本身有效,项目有没有开通计费要等真正出图时才知道。官方 REST 示例用 x-goog-api-key 请求头传 key;放在请求头里,也比拼进 URL 的 ?key= 参数更不容易被代理和服务器的访问日志记下来。
开通计费:图片模型没有免费层,预付最少 $5
图片模型在 Gemini API 免费层不可用,这一条从定价页的 Pro、Nano Banana 2、2.1 到 2 Lite 都一样。没开计费的项目调用图片模型时,常见的报错是 429 RESOURCE_EXHAUSTED,message 里带 limit: 0。这不是额度暂时用完,而是这个项目本来就没有图片额度,等多久都不会恢复,排查细节见 Gemini 图片生成 429 速率限制:先分清每分钟、每日和花费上限。
按 Gemini API 计费文档(2026 年 9 月 28 日更新),开通步骤是:
- 在 AI Studio 的 API Keys 页或 Projects 页,找到要升级的免费层项目,点 Billing Tier 一列里的 Set up billing。
- 从没建过 Google 结算账号的,先选国家并同意条款,再填联系信息和付款方式;建过的,直接选一个已有结算账号,或点 Add new billing account 新建。
- 新账号默认归入预付方案,要先预付至少 $5。早先开通、还在后付方案上的账号,Google 正在把它们迁到预付,按账号通知里的日期在 Billing 页点 Switch to Prepay 并买入额度即可;从预付切回后付不支持。
开通以后有几条规则会直接影响能不能出图:
- 余额为 0 就停。 付费层只在预付余额为正时处理请求。余额归零的那一刻,这个结算账号下所有项目里的所有 key 同时停用,请求返回 HTTP 402 Payment Required,直到充值为止。可以在 AI Studio 的 Billing 页面开自动充值,并给自动充值设一个每月上限。
- 预付额度有期限。 预付余额最多 $5,000,买入后 12 个月未用完即过期;预付账号不退款。
- $300 赠金不能用。 Google Cloud 的新用户赠金和免费试用额度不能用于 Gemini API 或 AI Studio;从 2026 年 3 月起,Gemini API 费用明确不在 $300 免费试用的覆盖范围内。
- 订阅不加 API 额度。 Google AI Pro、Ultra 这类消费者订阅只提高 Gemini 应用和 AI Studio 网页里的额度,不会给 API 项目增加任何配额,API 调用照样按项目计费。想了解 Gemini 应用、Flow 和 API 各自的免费规则,可以看 Nano Banana Pro 免费吗?Gemini 免费版用不了,Flow 与 API 规则。
付费层分三级,层级和上限都按结算账号判定,升级条件满足后会自动升级:
| 层级 | 条件 | 每月花费上限 | 每 10 分钟花费上限 |
|---|---|---|---|
| 免费层 | 有项目即可 | 不适用 | 不适用(图片模型不可用) |
| Tier 1 | 关联有效的结算账号 | $250 | $10 |
| Tier 2 | 已付 $100,且首次成功付款后满 3 天 | $2,000 | $50 |
| Tier 3 | 已付 $1,000,且首次成功付款后满 30 天 | $20,000–$100,000+ | $200 |
表中条件与每月上限来自 Gemini API 计费文档,10 分钟花费上限来自 Gemini API 速率限制文档(2026 年 10 月 9 日更新)。
Nano Banana Pro API 配额:按项目计算,Tier 1 每 10 分钟最多花 $10
Nano Banana Pro 的 API 配额没有一个统一的“每天 N 张”。限额按项目计算,数值由项目所挂结算账号的层级决定,分几层叠加:
- 每分钟请求数、token 数和图片数。 速率限制文档不再公布图片模型的具体数字,你的项目当前数值只能在 AI Studio 的速率限制页查看;其中每分钟图片数 IPM 只对能生成图片的模型计算。
- 每 10 分钟花费上限。 Tier 1 是 $10,Tier 2 是 $50,Tier 3 是 $200,超出时同样返回 429
RESOURCE_EXHAUSTED。 - 每月花费上限。 上一节表格里的 $250、$2,000 和 $20,000 以上。
- Batch 排队 token。
gemini-3-pro-image在 Tier 1 可排队 2,000,000 个 token,Tier 2 是 2.7 亿,Tier 3 是 10 亿(速率限制表里这一行仍写作 Gemini 3 Pro Image Preview)。
花费上限可以直接换算成张数。只算 1K/2K 的出图费:Tier 1 每 10 分钟最多约 $10 ÷ $0.134 ≈ 74 张,每月最多约 $250 ÷ $0.134 ≈ 1,865 张;4K 分别约 $10 ÷ $0.24 ≈ 41 张和 $250 ÷ $0.24 ≈ 1,041 张。输入 token 和思考 token 另外计费,实际张数会比这个少一些。
同一个项目里多建几个 key 不会让配额翻倍,因为限额算在项目上,不算在 key 上。要提额,只能升级层级、填 Google 的提额申请表,或者把不急的任务交给 Batch。各层级具体能出多少张、怎么申请提额,见 Nano Banana Pro API 配额提升:Tier 1 到 Tier 3 各能出多少张图。
用 gemini-3-pro-image 生成第一张图:Python、Node.js、REST
三个示例做同一件事:用 gemini-3-pro-image 生成一张 3:4、2K 的海报,跳过思考过程中的中间图,把最终图片存到本地。几个容易出错的地方:
responseModalities要包含IMAGE。 只写文字时,模型可能只回一段描述。- 尺寸写在
imageConfig里,imageSize取1K、2K或4K,K 必须大写;不传时默认 1K。宽高比用aspectRatio。 - 跳过
thought为 true 的部分。 Pro 默认开启思考,响应里可能带中间草图,只取不带thought标记的最后一张图。 - 超时留足。 2026 年 10 月 8 日的 1K 同题测试里,Pro 每张约 20 秒出图,4K 更久;客户端和代理的超时不要设得太短。
Python(google-genai SDK)
pip install -U google-genai
export GEMINI_API_KEY="你的 key"import os
from google import genai
from google.genai import types
client = genai.Client(
api_key=os.environ["GEMINI_API_KEY"],
# 不配置 retry_options 时 generate_content 不会自动重试
http_options=types.HttpOptions(
retry_options=types.HttpRetryOptions(attempts=4),
),
)
response = client.models.generate_content(
model="gemini-3-pro-image",
contents=(
"A minimalist poster for a coffee shop autumn menu. "
"Headline text: 'Autumn Menu'. Small text below: 'Open daily 8am-8pm'."
),
config=types.GenerateContentConfig(
response_modalities=["TEXT", "IMAGE"],
image_config=types.ImageConfig(aspect_ratio="3:4", image_size="2K"),
),
)
final_image = None
for part in response.parts or []:
if part.thought:
continue # 跳过思考过程中的中间图
if part.inline_data:
final_image = part.inline_data # 保留最后一张最终图
elif part.text:
print("模型回复:", part.text)
if final_image:
ext = final_image.mime_type.split("/")[-1]
with open(f"poster.{ext}", "wb") as f:
f.write(final_image.data) # SDK 已解码为 bytes,不要再 base64 解码
print(f"已保存 poster.{ext}")
else:
candidate = response.candidates[0] if response.candidates else None
print("没有拿到图片:", candidate.finish_reason if candidate else response.prompt_feedback)Python SDK 里的 inline_data.data 已经是解码后的二进制数据,直接写文件即可;再做一次 base64 解码会得到损坏的文件。
关于重试:Google 的故障排查文档说 Python SDK 默认会自动重试最多 4 次,但 google-genai 的 client.models.generate_content 在默认客户端下只发一次请求,遇到 429 直接抛错,传入 HttpRetryOptions 后才会重试(google-genai 2.28.0 的测试结果,1.65.0 的源码逻辑相同)。上面传了 attempts=4,即首次请求加 3 次重试,只对 408、429 和 5xx 生效,等待时间按指数退避加随机抖动增长,初始约 1 秒、最长 60 秒。
Node.js(@google/genai SDK)
npm install @google/genai
export GEMINI_API_KEY="你的 key"把下面的代码存成 generate.mjs,用 node generate.mjs 运行:
import { GoogleGenAI } from "@google/genai";
import fs from "node:fs";
const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
const response = await ai.models.generateContent({
model: "gemini-3-pro-image",
contents:
"A minimalist poster for a coffee shop autumn menu. " +
"Headline text: 'Autumn Menu'. Small text below: 'Open daily 8am-8pm'.",
config: {
responseModalities: ["TEXT", "IMAGE"],
imageConfig: { aspectRatio: "3:4", imageSize: "2K" },
},
});
const candidate = response.candidates?.[0];
let finalImage = null;
for (const part of candidate?.content?.parts ?? []) {
if (part.thought) continue; // 跳过思考过程中的中间图
if (part.inlineData) finalImage = part.inlineData;
else if (part.text) console.log("模型回复:", part.text);
}
if (finalImage) {
const ext = finalImage.mimeType.split("/")[1];
fs.writeFileSync(`poster.${ext}`, Buffer.from(finalImage.data, "base64"));
console.log(`已保存 poster.${ext}`);
} else {
console.log("没有拿到图片:", candidate?.finishReason ?? response.promptFeedback);
}Node.js SDK 返回的 inlineData.data 是 base64 字符串,需要先用 Buffer.from(..., "base64") 转成二进制再写文件。这个示例没有加重试;需要时自己包一层指数退避,只对 429、408 和 5xx 重试。
REST(cURL)
curl -s -X POST \
"https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
--max-time 300 \
-d '{
"contents": [{
"parts": [{"text": "A minimalist poster for a coffee shop autumn menu. Headline text: Autumn Menu."}]
}],
"generationConfig": {
"responseModalities": ["TEXT", "IMAGE"],
"imageConfig": {"aspectRatio": "3:4", "imageSize": "2K"}
}
}' > response.json
# 取最后一张非思考图片;没有图片时打印报错和 finishReason
jq -r '[.candidates[0].content.parts[]? | select(.inlineData and (.thought | not))] | last | .inlineData.data // empty' response.json \
| base64 --decode > poster.png
[ -s poster.png ] || jq '{error, promptFeedback, finishReason: .candidates[0].finishReason}' response.json最终图片在 candidates[0].content.parts 里带 inlineData 的那一项,mimeType 字段说明实际格式,不一定是 PNG。
如果拿到 HTTP 200 却没有图片,先看 finishReason 和 promptFeedback:IMAGE_SAFETY、IMAGE_PROHIBITED_CONTENT 是安全策略拦截,NO_IMAGE 是模型这次没能生成图片。逐个字段的判断方法见 Nano Banana API 不出图:按返回字段逐项排查。内容拦截、限流和账号处置分别由什么触发,见 Nano Banana Pro 风控:拦截、限流、封号各由什么触发,怎么处理。
提示词写得越具体,结果越稳定:主体、场景、光线、镜头和构图都写清楚,比只写“一只猫”可控得多。需要图里出现文字时,把原文放进引号并写明位置和字号。要出 4K 图,各比例对应的像素和参数设置见 Nano Banana Pro 4K 完全指南:10 种比例分辨率、参数设置与水印。
Nano Banana Pro API 价格:1K/2K 每张 $0.134,4K $0.24,Batch 半价
截至 2026 年 10 月 10 日,Gemini API 和 Vertex AI 的标准价相同,下表是每张输出图片的价格:
| 模型(模型 ID) | 1K | 2K | 4K | Batch |
|---|---|---|---|---|
Nano Banana Pro(gemini-3-pro-image) | $0.134 | $0.134 | $0.24 | 1K/2K $0.067,4K $0.12 |
Nano Banana 2.1(gemini-nano-banana-2.1) | $0.0336 | $0.0504 | $0.113 | $0.0168 / $0.0252 / $0.0567 |
这个单价只算图片输出。Pro 的输入按每百万 token $2 计(一张输入图约合 $0.0011),文字和思考输出按每百万 token $12 计,都另外收费。使用 Google 搜索建立依据时,每月前 5,000 次搜索由所有 Gemini 3.x 模型共用,超出后每 1,000 次 $14。
Batch 按标准价的一半计费,Google 给的目标周转时间是 24 小时,多数情况会快得多,适合夜间批量出商品图这类不需要立即返回的任务。定价页上还列着 Pro 的 Flex 价格(与 Batch 同价),但 gemini-3-pro-image 的模型页和 Flex 推理文档都没有把 Pro 列为支持 Flex 的模型,想拿半价就用 Batch。
另有第三方平台按次计价:老张API 的 Nano Banana Pro 接入文档列出 gemini-3-pro-image 每次调用 $0.09,平台的说明是 1K、2K、4K 同价;用的是老张API 自己的 key 和余额,不是 Google 的 key。
说明:laozhang.ai 是我们自己的服务,其价格是平台报价,不是独立比较的结论。

旧的 gemini-2.5-flash-image 的停用日期,Google 自己的页面说法不一:更新日志和定价页写 2026 年 10 月 2 日,弃用表写 2027 年 3 月 15 日。不管哪个为准,新项目要省钱都应改用 Nano Banana 2.1。
用每天 100 张、每月 30 天,也就是 3,000 张来算(只算出图费):
| 方案 | 计算 | 每月 |
|---|---|---|
| Pro 标准价,1K/2K | 3,000 × $0.134 | $402 |
| Pro Batch,1K/2K | 3,000 × $0.067 | $201 |
| Nano Banana 2.1 标准价,2K | 3,000 × $0.0504 | $151.20 |
| Nano Banana 2.1 标准价,1K | 3,000 × $0.0336 | $100.80 |
注意第一行:$402 已经超过 Tier 1 每月 $250 的花费上限,这个用量要么等项目升到 Tier 2,要么把一部分任务改走 Batch 或换 2.1。
Pro 和 2.1 用同一个 key,换模型只需改模型 ID。选哪一个取决于图里的文字:2026 年 10 月 8 日的 9 组同题测试(1K,每题一张)里,Pro 在海报、菜单这类文字题上保留了要求的原文,2.1 有三道文字题改动了措辞,连同 GPT Image 2.5 在内,三个模型都把“单”写成了日文字形“単”。商品图、插画、社交配图这类文字不关键的任务用 2.1,1K 单价约是 Pro 的四分之一($0.0336 对 $0.134);要求一字不差的海报和包装再用 Pro。完整对比见 Nano Banana 2.1 vs Pro vs GPT Image 2.5 对比:9 组同题实测,2.1 的入口与各分辨率价格见 Nano Banana 2.1 价格与入口,Pro 的完整定价拆解见 Gemini 3 Pro Image API 定价 2026:1K/2K 每张 $0.134,4K $0.24,把 API 和 Gemini 订阅放在一起算每张合格图成本见 Nano Banana Pro 多少钱?API、订阅与每张合格图成本(2026)。如果还在 Pro 和其他厂商的模型之间犹豫,可以参考 FLUX.2 Pro 与 Nano Banana Pro 怎么选:改图、中文海报与单张成本。
中国大陆不在 Gemini API 支持地区
Gemini API 与 AI Studio 的可用地区列表(2026 年 4 月 28 日更新)不包含中国大陆、香港和澳门,台湾在列表内。上面的建 key、开计费和出图步骤,只在列表内的地区适用。
常见报错:400 API key not valid、402、403、429 和 200 无图
同一个错误在两套接口上的写法不同:generateContent(多数 SDK 示例和上面的 cURL 用的就是它)返回 gRPC 风格的 status,比如 INVALID_ARGUMENT、RESOURCE_EXHAUSTED;Interactions API 返回小写的 code,比如 authentication、rate_limit_exceeded。下表按 Google 的API 错误参考(2026 年 9 月 20 日更新)整理,两种写法都列出来:
| HTTP 状态与写法 | 常见原因 | 怎么处理 | 重试吗 |
|---|---|---|---|
400 INVALID_ARGUMENT,reason 为 API_KEY_INVALID(Interactions API 为 401 authentication) | key 复制不完整、带了空格或换行,或已删除、已过期 | 回 AI Studio 重新复制,或新建一个 key | 不重试 |
400 failed_precondition | 前提条件不满足,比如项目计费被停用 | 在 AI Studio 的 Projects 页看 Billing Tier 和 Status 列 | 不重试 |
402 Payment Required(payment_required) | 预付余额用完;同一结算账号下所有 key 同时停用 | 充值或开启自动充值 | 不重试,充值前不会成功 |
403 PERMISSION_DENIED(permission_denied) | key 对这个资源没有权限,key 的 API 限制或来源限制挡住了请求;请求没带 key 也会返回 403 | 检查 key 的限制设置和所属项目 | 不重试 |
404(model_not_found) | 模型名不存在:拼错了,或者还在用已停用的 gemini-3-pro-image-preview | 改成 gemini-3-pro-image | 不重试 |
429 RESOURCE_EXHAUSTED(rate_limit_exceeded、quota_exceeded、too_many_requests) | 免费层项目调用图片模型(limit: 0)、每分钟限额、每日配额、10 分钟花费上限 | 先分清是哪一种:limit: 0 去开计费;每分钟限额用退避;每日配额等重置或申请提额 | 只对短时限流重试 |
| 500、503、504 | 服务端错误、过载或超时 | 指数退避加随机抖动,设最大重试次数 | 重试 |
| 200 但没有图片 | 安全拦截(IMAGE_SAFETY 等)、只回了文字、NO_IMAGE | 看 finishReason 和 promptFeedback,改写提示词 | 原样重发通常还会被拦 |
Google 的故障排查文档(2026 年 10 月 1 日更新)给的重试原则是:只对 429、408 和 5xx 这类临时错误重试,用指数退避加随机抖动并设最大次数;400、402、403 不要重试,它们意味着 key 无效、预付余额耗尽或请求写错,重发只会继续失败。
429 是 Nano Banana Pro 最常见、也最容易处理错的报错,因为免费层的 limit: 0、每分钟限流、每日配额和花费上限都报同一个状态,处理方法却完全不同。按报错内容区分并附 Python、Node.js 恢复代码的完整排查,见 Nano Banana Pro RESOURCE_EXHAUSTED 429:排查与 Python、Node.js 恢复代码。其他错误的汇总入口是 Nano Banana Pro 错误排查中心:全部错误代码修复指南;按错误码逐个查也可以看 Nano Banana Pro 错误代码完整排错指南 和 Nano Banana Pro 故障排除中心,这两篇写于 2026 年 2 月,其中的模型 ID 请换成 gemini-3-pro-image。
API Key 安全:只限 Gemini API、设项目月度花费上限
key 泄露后产生的费用由 key 所属项目承担。Gemini API 的 API Key 文档要求把 key 当作密码对待,下面几项建议按重要程度排列:
不进代码,不进前端。 key 只放在服务器的环境变量或密钥管理服务里,不提交到 Git,也不放进浏览器或移动端代码。本地开发用 .env 文件时,先把 .env 加进 .gitignore:
# .env,不要提交到版本控制
GEMINI_API_KEY=你的 keyPython 可以用 python-dotenv(from dotenv import load_dotenv; load_dotenv()),Node.js 可以用 dotenv(import "dotenv/config")。生产环境优先用平台自带的密钥管理,例如 Google Cloud Secret Manager、AWS Secrets Manager 或 Vercel 的环境变量。
限制 key 的用途和来源。 只给 Gemini 用的标准 key,在 AI Studio 的 API Keys 页点 Restrict to Gemini API only;需要更细的控制时,到 Google Cloud Console 的“API 和服务 → 凭据”里限定可调用的 API,并按 IP 地址、网站或应用限制请求来源。新建的 auth key 绑定服务账号,权限可以按服务账号收紧。
给项目设每月花费上限。 有项目编辑者、所有者或管理员角色的账号,可以在 AI Studio 的 Spend 页面设置 Monthly spend cap。这个功能目前是实验性的,计费数据约有 10 分钟延迟,Batch 这类长任务可能超出上限一些。预付本身也是一道保险:余额花完请求就停,再配合自动充值的每月上限,泄露造成的损失有封顶。
定期轮换。 同一个项目可以同时有多个 key:先建新 key,部署上线,确认正常后删除旧 key,整个过程不必停服务。
盯用量。 AI Studio 的 Dashboard → Usage 页面能看到项目用量。用量在应用本该空闲的时段突然上涨,往往是 key 泄露的早期信号。面向用户的应用最好在客户端和 Gemini API 之间加一层自己的服务端代理,让真实 key 始终不离开服务器。
Nano Banana Pro API Key 常见问题
Nano Banana Pro API Key 免费吗? 创建 key 免费,出图不免费。截至 2026 年 10 月 10 日,图片模型在 Gemini API 免费层不可用,项目必须开通计费,新账号最少预付 $5,Pro 1K/2K 每张 $0.134;Google AI Pro、Ultra 订阅也不给 API 增加额度。Google Cloud 的 $300 赠金同样不能用于 Gemini API。
只创建 Nano Banana Pro API Key,需要先绑卡吗? 不需要。在 AI Studio 建 key 不要求结算账号,新用户进入时系统还会自动建好一个。要等调用图片模型前点 Set up billing 时,才需要填付款方式并预付。
AI Studio 里能免费试 Nano Banana Pro 吗? AI Studio 网页本身不收费,但 Playground 里的图片模型要有 Google AI 订阅或关联付费 API key 才能用。订阅带来的额度只在 AI Studio 网页里有效,用 key 直接调 API 仍按项目计费。
同一个 key 能调用 Nano Banana 2.1 吗?
能。key 属于项目,不属于某个模型,把模型 ID 换成 gemini-nano-banana-2.1 即可,请求和响应格式相同。2.1 同样没有免费层,1K 每张 $0.0336。
2026 年 5 月 28 日之前建的 key 还能用吗? 要看它有没有加限制。加了限制的标准 key 仍然可用;没有任何限制(标着 Unrestricted)的标准 key,Gemini API 会拒绝它的请求。处理办法是在 AI Studio 里点 Restrict to Gemini API only,或者新建一个 auth key 替换。
一个 API Key 能给多个应用用吗? 技术上可以,但不建议。一个应用泄露 key,所有共用它的应用都要跟着换。更稳妥的做法是在同一项目里给开发、预发布、生产环境各建一个 key,真正独立的业务用不同项目,配额和账单也能分开。
生成 1,000 张 Nano Banana Pro 图片要多少钱? 只算出图费,1K/2K 标准价是 1,000 × $0.134 = $134,Batch 为 $67;4K 标准价 $240,Batch 为 $120。输入和思考 token 另计。同样 1,000 张,换成 Nano Banana 2.1 的 1K 是 $33.60。
生成的图片能保存多久?
generateContent 把图片以 base64 数据直接放在响应的 inlineData 里返回,不提供托管链接,收到后要自己保存;存下来的文件不会过期。如果你在其他工具里遇到图片链接失效的问题,见 Nano Banana 临时图片与 Bug 修复:2026 完整排错指南。
可以用 Vertex AI 调用 Nano Banana Pro 吗?
可以。Vertex AI(现已并入 Gemini Enterprise Agent Platform)同样提供 gemini-3-pro-image,标准价与 Gemini API 相同,Google 列出的停止支持时间为“2027 年 5 月 28 日或之后”。Vertex 用 Google Cloud 的 IAM 凭据认证,适合需要细粒度权限、组织策略或企业合规的团队;个人开发者和小团队用 AI Studio 的 key 上手最快。Google Cloud 免费试用页面没有把 Vertex 上的 Gemini 模型排除在外,$300 赠金也许能抵 Vertex 的出图费,但这一点没有经过实际调用验证。配置步骤和费用见 Vertex AI 调用 Nano Banana:正确配置与费用。
参考来源10
本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月10日。
参考来源10
本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月10日。
- 1.Google AI Studio 的 API Keys 页面aistudio.google.com/apikey
- 2.Gemini API 定价页ai.google.dev/gemini-api/docs/pricing
- 3.Gemini API 弃用页ai.google.dev/gemini-api/docs/deprecations
- 4.Gemini API 的 API Key 文档ai.google.dev/gemini-api/docs/api-key
- 5.Gemini API 计费文档ai.google.dev/gemini-api/docs/billing
- 6.Gemini API 速率限制文档ai.google.dev/gemini-api/docs/rate-limits
- 7.AI Studio 的速率限制页aistudio.google.com/rate-limit
- 8.故障排查文档ai.google.dev/gemini-api/docs/troubleshooting
- 9.可用地区列表ai.google.dev/gemini-api/docs/available-regions
- 10.API 错误参考ai.google.dev/gemini-api/docs/api-errors





