Gemini 图片生成 API 免费吗：已无免费层，标准价最低每张 $0.0336

没有免费的了，新出的 Nano Banana 2.1 也一样。 截至 2026 年 10 月 8 日，Gemini API 里现役的四个图片模型，Nano Banana 2 Lite（gemini-3.1-flash-lite-image）、Nano Banana 2.1（gemini-nano-banana-2.1）、Nano Banana 2（gemini-3.1-flash-image）和 Nano Banana Pro（gemini-3-pro-image），在 Google 定价页的免费层一栏都写着“Not available”：免费 API key 调不出图片。Google AI Studio 的 Playground 也一样，截至 10 月 5 日，没有付费 key、也没有 Google AI 套餐的账号，选中 Nano Banana 2 或 Nano Banana 2 Lite 只会看到升级提示。

网上流传的“每天 500 次免费、无需信用卡”，说的是第一代 Nano Banana gemini-2.5-flash-image。它的免费层现在同样不出图，模型本身也在弃用期，Google 两个页面写的关停日期还对不上，新项目不要再用。现在用 API 出图，按标准价最便宜的是每张 $0.0336 的 1K 图，Nano Banana 2 Lite 和 Nano Banana 2.1 同价；不需要实时返回的批量任务走 Batch，两者都是每张 $0.0168。起步要先在 AI Studio 开通结算、预充 $5。只想要几张图、不需要写代码的话，Gemini 应用、Google 搜索的 AI 模式和 Google Flow 仍然可以免费出图。中国大陆不在 Gemini API 的可用地区内，后面单独说明。

2026 年 10 月 8 日这次更新改了这几处：

• Nano Banana 2.1 已正式发布：10 月 6 日起 GA，是 Nano Banana 2 的升级版，API 同样没有免费层；1K 每张 $0.0336，2K $0.0504，4K $0.113。
• Nano Banana 2 在 Gemini API 上已弃用：Google 的更新日志写的是“no shutdown date announced”，没有公布停用日期，建议迁移到 2.1。在 Vertex AI 上，它的支持期写到 2027 年 5 月 28 日或更晚。
• gemini-2.5-flash-image 的关停日期两页冲突：弃用时间表写 2027 年 3 月 15 日，定价页仍写 2026 年 10 月 2 日，详见下文。
• Gemini 应用：免费用户用 Nano Banana 2 出图，Nano Banana 2.1 要 Google AI 套餐。

Gemini 图片 API 免费层：包括 2.1 在内，现役模型都不出图

四个现役图片模型的免费层输入、输出全部标为“Not available”，只有开通结算的付费层能用。价格如下，来自 Gemini API 定价页，截至 2026 年 10 月 8 日，美元计价：

“最低每张 $0.0336”指的是标准价：Lite 只出 1K，2.1 只有 1K 是这个价，到 2K、4K 就分别是 $0.0504 和 $0.113。把 Batch 算进来，最低是 Lite 或 2.1 的 1K 图，每张 $0.0168。

每张价是 Google 按输出图片的 token 数折算出来的。提示词、上传的参考图按输入 token 另计，文字与思考输出也另计，每 100 万 token 的单价是 Lite $1.50、Nano Banana 2 $3、2.1 $7.50、Pro $12，所以真实账单会比表里高一些。2.1 和 Lite 的 1K 图片价一样，但 2.1 默认开着中等档的思考，文字与思考输出的单价是 Lite 的 5 倍，单次实际花费通常比 Lite 高，算例见下文“预充 $5 能生成多少张”一节。

“免费 Gemini API key”这句话本身没错：在 AI Studio 创建 key 不收费。但 key 只是凭据，没开结算的项目处在免费层，而免费层不含任何图片模型的输出。Gemini API 的速率限制按项目计算、不按 key 计算，多建几个 key 也换不来出图额度。

AI Studio 本身不收费，Google 计费文档的原话是“AI Studio usage remains free of charge unless users link a paid API key for access to paid features”，图片模型就属于这类付费功能。截至 2026 年 10 月 5 日，没有 Google AI 套餐、也没有绑定 API key 的个人账号在 Playground 里选 gemini-3.1-flash-image，会看到“Nano Banana 2 is only available in the Playground via a Google AI Plan or an API key”；选 gemini-3.1-flash-lite-image 则提示“Upgrade to unlock Nano Banana 2 Lite”。升级弹窗只给两条路：按请求付费的 Gemini API，或按月订阅的 Google AI 套餐。哪一档套餐能解锁 AI Studio 里的哪些图片模型，Google 没有公开写明。

“每天 500 次免费”为什么失效：gemini-2.5-flash-image 已无免费层

旧教程里的免费额度属于 gemini-2.5-flash-image，付费价每张 $0.039。截至 2026 年 10 月 8 日，定价页上它的免费层同样标为“Not available”，那 500 次已经不存在了。

这个模型还能用多久，Google 自己的两个页面说法不一：

• Gemini API 弃用时间表写的关停日期是 2027 年 3 月 15 日，替代模型是 Nano Banana 2 Lite。
• 定价页在它那一栏仍挂着旧提示：将于 2026 年 10 月 2 日关停，请迁移到 Nano Banana 2 或 Nano Banana 2 Lite。

Vertex AI 的模型版本页同样写的是 2027 年 3 月 15 日。不管哪个日期准，它都处在弃用期，随时可能停止响应，新代码不要再用它，已有代码迁到 Lite（1K 单图）或 2.1（要更高分辨率或多张参考图）。弃用时间表还显示，gemini-3-pro-image-preview 和 gemini-3.1-flash-image-preview 两个预览版 ID 已在 2026 年 6 月 25 日关停。

所以照着旧教程复制的代码，现在通常卡在下面四处之一，按顺序排查：

1. 模型 ID 还是旧的：带 -preview 的 ID 已关停，请求不会再返回图片；gemini-2.5-flash-image 在弃用期内，Nano Banana 2 也已弃用。换成 Lite 或 2.1 的 ID。
2. 换了 ID，项目没开结算：免费层没有任何图片模型的出图额度，仍然拿不到图片。
3. 开了预充，余额用完：预充余额归零时，同一结算账号下所有项目的 key 会同时停用，请求返回 HTTP 402 Payment Required，充值后恢复。
4. 付费后报 429 RESOURCE_EXHAUSTED：超过了每分钟请求数、每分钟图片数等限额，或者触发了消费速率上限（Tier 1 是每 10 分钟 $10）。等一会儿再试、降低并发即可，长期不够用再申请提额。

旧代码用的 generate_content 写法本身还能用：API 参考里 generateContent 仍是有效接口，图片尺寸和比例通过 generationConfig.imageConfig 设置。Google 图片生成指南的新示例改用了 Interactions API，下文的最小请求也用这种写法。

免费的还剩哪些：文本模型免费层，和三个不走 API 的出图入口

API 里免费的只剩文本类模型。 定价页上 Gemini 3.8 Flash 等文本模型的免费层输入、输出标为“Free of charge”，适合先免费调提示词、写业务逻辑，等到真正出图时再换成付费项目。注意免费层那一栏还写着“Used to improve our products: Yes”，提示词和输出可能被 Google 用来改进产品，付费层这一项是 No。哪些模型在免费层、限额是多少，见 Gemini API 免费层还剩哪些模型和限额。

只要图片、不需要 API，Google 自己的三个入口还能免费用：

• Gemini 应用：没有套餐的用户用 Nano Banana 2 出图，Google 的介绍页把它标为免费；Nano Banana 2.1 要 Google AI 套餐，Google AI Plus、Pro、Ultra 用户用 2.1 出图，还能对结果选“Redo with Pro”。用量按算力计、每 5 小时刷新、有每周上限，Google 不公布每天能出几张。
• Google 搜索的 AI 模式：没有套餐的账号每 24 小时最多 25 张，要求 18 岁以上，只在名单内的国家和地区可用。
• Google Flow：有不扣积分的图片模型，但当前用哪个模型、每天给多少积分变动较多。

这三个入口都只能在网页或应用里手动操作，不能从代码调用。各入口的门槛和地区名单见 Nano Banana 能免费用吗：官方入口、限额与地区门槛，Gemini 应用每天能出几张、用完怎么办见 Gemini 免费生图次数限制。

只要几张图可选择手动免费入口；从代码调用图片模型则需要付费项目，订阅权益不能直接当作 API 额度。

$300 赠金、学生优惠能抵 Gemini 图片 API 费用吗

$300 赠金不能。 Google 计费文档写明，Google Cloud 的欢迎赠金和免费试用赠金“can't be used towards the Gemini API or AI Studio”，从 2026 年 3 月起 Gemini API 费用明确排除在 $300 免费试用之外；3 月 2 日之后开的结算账号拿到的赠金只能用在其他 Google Cloud 产品上。在那之前已经拿到赠金的，可以在到期前（90 天内）继续花在 Gemini API 上。

Google Cloud 免费试用的排除清单点名的是“AI Studio 里的 Gemini API 费用”，没有点名 Vertex AI 上的 Gemini 模型。赠金能不能在 Vertex AI 上抵图片模型的费用，公开文档没有直接回答，想走这条路先在 Cloud 控制台的结算报告里看清扣的是赠金还是现金。

学生优惠也不能。 学生免费一年的 Google AI Pro 或 Plus 是 Gemini 应用的订阅，不附带 API 出图额度，详见 Gemini API Key 学生免费吗：优惠和免费层是两回事。Google AI 套餐能解锁 AI Studio Playground 里的图片模型（升级弹窗里写明），但那是按月付费的订阅；在自己的代码里调用，仍按 Gemini API 的价格计费。

最便宜的正规起步：预充 $5 能生成多少张

开通付费层的步骤：在 AI Studio 的 API keys 或 Projects 页面找到项目，点 Set up billing，关联一个 Cloud Billing 结算账号，再预充至少 $5。2026 年 3 月 23 日起新用户默认使用预充（Prepay）模式，开通后项目会从免费层升到 Tier 1，通常即时生效。

$5 能出多少张，按“张数 = 5 ÷ 每张价，向下取整”计算：

这些张数只算了输出图片，没算提示词、参考图和思考输出的 token，实际会少一些，2.1 少得更明显。举个例子：2026 年 10 月 8 日经老张API 用 2.1 出一张 1K 图，响应里报告的用量是提示词 42 token、图片 1,120 token、思考 854 token、其他文本输出 394 token。按 Google 的标准单价算：图片 1,120 × $30 / 100 万 = $0.0336，思考加文本 1,248 × $7.50 / 100 万 ≈ $0.0094，提示词 42 × $1.50 / 100 万 ≈ $0.0001，合计约 $0.043。同样 1,248 个文字与思考 token 如果按 Lite 的 $1.50 单价算只要约 $0.0019，这是 1K 单图优先选 Lite 的原因。这只是一次调用的数字，思考 token 每次不同。

预充之前还要知道几条规则，都写在 Gemini API 计费文档里：

• 预充额度 12 个月后过期，不退款（转为后付费时剩余额度会退回）。
• 计费流水大约有 10 分钟延迟，Batch 这类长任务可能在系统停下之前超出余额继续扣费。
• 返回 400 或 500 错误的请求不收费，但仍计入限额。

模型怎么选：只要 1K 图、一次出图不反复修改，用 Nano Banana 2 Lite 最省；它不适合多张参考图和多轮连续编辑，也不支持用 Google 搜索建立依据。要 2K、4K、多张参考图或反复编辑，新项目用 Nano Banana 2.1：2K 每张 $0.0504，比 Nano Banana 2 的 $0.101 便宜一半，4K 的 $0.113 比 $0.151 便宜约 25%。2.1 的入口、各档价格和与 Nano Banana 2 的差别见 Nano Banana 2.1 价格与入口：1K/2K 比 NB2 便宜一半，4K 只省 25%。Nano Banana 2 只剩 0.5K（每张 $0.045）这一档是 2.1 没有的，已有代码可以先跑着，但它已弃用，详见 Nano Banana 2 API 价格：每张 $0.045–$0.151，已弃用，2.1 更便宜。文字必须一字不差的海报、品牌素材这类复杂任务才值得上 Nano Banana Pro，它的各档价格见 Gemini 3 Pro Image API 定价，和 2.1 的同题出图对比见 Nano Banana 2.1 vs Pro vs GPT Image 2.5 对比：9 组同题实测。不需要实时返回的批量任务用 Batch，价格减半，结果异步取回，细节见 Nano Banana Pro Batch API 成本。

第一张图怎么发：Nano Banana 2 Lite 的最小 Python 请求

前提是你已经有一个开通结算的项目，并把它的 key 设为环境变量 GEMINI_API_KEY；免费层的 key 跑这段代码拿不到图片。先安装或升级官方 SDK：pip install -U google-genai。

下面的代码按 Google 图片生成指南（2026 年 9 月 23 日更新）里的 Interactions 写法整理，没有实际运行过：

import base64
from google import genai

client = genai.Client()  # 从环境变量 GEMINI_API_KEY 读取 key

interaction = client.interactions.create(
    model="gemini-3.1-flash-lite-image",
    input="A paper boat on a calm lake at sunrise, minimalist poster style",
    response_format={
        "type": "image",
        "mime_type": "image/jpeg",
        "aspect_ratio": "16:9",
    },
)

with open("boat.jpg", "wb") as f:
    f.write(base64.b64decode(interaction.output_image.data))

几处可以直接改的地方：

• 换模型：要 2K 或 4K，把 model 改成 gemini-nano-banana-2.1，并在 response_format 里加 "image_size": "2K"。尺寸必须写大写 K，"2k" 会被拒绝。Lite 只出 1K，不用设尺寸。2.1 不支持 0.5K，默认开着思考，思考 token 按输出另计。
• 比例：Lite 支持 1:1、3:2、2:3、3:4、4:3、4:5、5:4、9:16、16:9、21:9。2.1 在这 10 种之外还支持 1:4、4:1、1:8、8:1 四种长条比例。
• 编辑已有图片：把 input 改成列表，一项放文字说明，一项放图片，例如 {"type": "image", "data": base64.b64encode(image_bytes).decode("utf-8"), "mime_type": "image/png"}。上传的图片按输入 token 计费。2.1 最多可放 14 张参考图。

Google 在指南里提醒，上传的图片必须有使用权，不得生成欺骗、骚扰或伤害他人的内容。所有生成的图片都带 SynthID 隐形水印。REST 请求、JSON 模板和常见报错，见 Nano Banana Pro API 怎么调用。

“免费 Gemini 图片 API”网站和开源项目怎么判断

Google 自己没有免费出图的 API 层，所以任何“免费、无限量调用 Gemini 出图”的服务，图片的钱一定有人在付。用之前先问四个问题：

1. 用的是谁的 key：服务方自己的付费 key，额度随时可能收紧或停掉；要你登录自己的账号、费用记在你名下；或者是转发你自己 key 的开源代理，那仍然是你的付费 key。没有一种情况是 Google 免费层在出图。
2. 你签的是谁的条款：这是你和第三方之间的合同，不是 Google 的 Gemini API 条款。图片能否商用、出问题找谁、账号会不会被停，都看对方的条款。
3. 提示词和图片去哪：请求经第三方服务器中转，可能被记录或留存。处理客户素材、未公开的产品图之前，先看对方的隐私条款。
4. 能用多久：没有公开价格和服务承诺的“免费”多半是推广期。还在宣传 gemini-2.5-flash-image 免费额度的页面，可以直接判定信息过时；声称 Nano Banana 2.1 有 API 免费额度的，同样与 Google 定价页不符。

共享账号、转卖的 Google API key 来路不明，随时可能失效，出了问题计费和数据责任都说不清，不要用。

在中国大陆能用 Gemini 图片 API 吗

官方渠道不能。截至 2026 年 10 月 5 日，Gemini API 与 AI Studio 的可用地区列表不含中国大陆、香港和澳门，AI Studio 还要求年满 18 岁。不在列表内的地区无法按上面的步骤开通付费层。付款前该核对哪些合同和结算责任，见 Gemini API Key 购买前先看：中国大陆的地区、付费与凭据路线。

需要在国内调用的开发者，可以考虑老张API 这类付费中转，它同样不是免费方案。按 老张API 的 Nano Banana 2.1 文档截至 2026 年 10 月 7 日的公示价，Nano Banana 2.1 每次 $0.045，1K、2K、4K 同价；Nano Banana 2 Lite 每次 $0.025，Nano Banana 2 每次 $0.055，Nano Banana Pro 每次 $0.09。和 Google 官方标准价比，2.1 的 2K（$0.0504）、4K（$0.113）和 Pro 的 1K/2K（$0.134）、4K（$0.24）按次价都更低；2.1 的 1K 官方图片价 $0.0336 更低，算上思考 token 后两边接近。只要价格最低、能等异步结果的话，官方 Batch 的 1K 每张 $0.0168 仍是最便宜的。使用时注意三点：

• 返回 HTTP 200 但没有图片，也按一次计费。
• 尺寸和比例只能在 Gemini 原生格式的接口里设置，OpenAI 兼容接口只出 1K 图。
• 底层仍是 Google 的模型，Google 的安全策略照样生效。

Google 直连和中转各适合什么场景，取决于你所在的地区、调用量和对稳定性的要求。

常见问题：免费 key、AI Studio、限制与报错

Gemini 的免费 API key 能生成图片吗？

不能。免费 key 所在的项目处在免费层，Nano Banana 2 Lite、Nano Banana 2.1、Nano Banana 2 和 Nano Banana Pro 在免费层都不提供出图。免费 key 只能调用免费层里的文本类模型；要出图，项目必须开通结算并预充至少 $5。

Nano Banana 2.1 有免费额度吗？

API 没有。截至 2026 年 10 月 8 日，Google 定价页上 2.1 的免费层一栏是“Not available”，付费后 1K 每张 $0.0336，Batch 每张 $0.0168。Gemini 应用里也要 Google AI 套餐才能用 2.1，没有套餐的用户用的是 Nano Banana 2。

在 Google AI Studio 里生成图片要钱吗？

AI Studio 网页本身不收费，但截至 2026 年 10 月 5 日，Playground 里的 Nano Banana 2 和 Nano Banana 2 Lite 要求 Google AI 套餐或付费 API key 才能使用。绑定付费 key 后，在 AI Studio 里出的图按 API 价格计费，2.1 也一样。

Gemini 生成图片有哪些限制？

API 这边主要有三类：付费层的每分钟请求数、每分钟图片数和消费速率上限，按项目计算；模型本身的规格，例如 Lite 只出 1K、2.1 不出 0.5K；还有内容政策，涉及真实人物、暴力或色情的请求可能被拦截。人物相关的规则和合规做法见 Gemini 拒绝生成人物图片的原因与合规做法。

Gemini API 无法生成图片是什么原因？

先看返回内容：模型 ID 已关停或已弃用时换成 Lite 或 2.1；项目在免费层时开通结算；HTTP 402 是预充余额用完；429 RESOURCE_EXHAUSTED 是触发了限额。请求成功但没有图片时，看 finishReason 是否为 IMAGE_SAFETY、IMAGE_PROHIBITED_CONTENT 或 IMAGE_OTHER，这类结果来自内容审核，不是额度问题。

用 Gemini API 编辑图片也要付费吗？

要。编辑和生成走同一个模型，输出的图片按同样的每张价计费，上传的原图另按输入 token 计费；Nano Banana Pro 每张参考图约 $0.0011。换背景这类编辑的提示词写法见 用 Gemini 换图片背景的方法。

Gemini API 生成的图片有水印吗？

有隐形水印。Google 的图片生成指南写明所有生成的图片都带 SynthID，肉眼看不见，也去不掉。看得见的水印是 Gemini 应用里的设置，和 API 无关：在“设置”的 Media Watermark 开关里可以自己开关，有没有套餐都一样；在印度、韩国、越南，只有 AI Ultra 用户能看到这个开关，其他人的图一律带可见水印。这个开关只管可见水印，SynthID 和 Content Credentials 内容凭据始终保留，见 Google 的 Gemini 水印设置说明。