Nano Banana API 怎么选：原版、Nano Banana 2 还是 Pro

API 里选择 Nano Banana 模型时，默认路线应该是 Nano Banana 2（gemini-3.1-flash-image-preview）：它覆盖 0.5K 到 4K，价格低于 Pro，能力足够承担大多数产品图、内容图和工作流配图。原版 Nano Banana（gemini-2.5-flash-image）只适合简单、低风险、1024px 级别输出；Nano Banana Pro（gemini-3-pro-image-preview）适合文字、图表、复杂版式、品牌素材和任何返工成本高的最终图。

先把三条路线放在一张表里：

实际工程里不要把价格档位、市场叫法和模型 ID 混在一起。Google 的 Standard pricing 可以用来理解计费模式，但代码里必须落到上面三个模型字符串之一。本文里的价格和 preview 状态按 2026 年 4 月 20 日 Google AI 文档核对；账户额度、项目限制和可用性仍要以当前 Google 控制台或 AI Studio 为准。

先把三个 API 路线分清楚

Nano Banana 在中文语境里已经像一个家族名，但生产代码不能靠家族名路由。可靠的 API 集成至少要同时明确四件事：模型 ID、目标尺寸、价格路线、切换理由。只问“哪个最好”会让成本和质量都失控；先问“这张图失败以后代价有多高”更接近真实决策。

原版 Nano Banana 是低成本基线。它仍然有价值，尤其是旧项目已经围绕 1024px 输出调好提示词，或者任务只是内部占位图、简单缩略图、低风险素材。它不应该成为新工作流的默认选项，因为 2K/4K、文字可读性和复杂布局都不是它的强项。

Nano Banana 2 是默认路线。它覆盖的尺寸最完整，从 0.5K 预览到 4K 输出都能走同一个模型家族，适合内容平台、SaaS 产品图、帮助文档配图、商品概念图和本地化图片。成本比 Pro 低，能力又比原版更适合新项目，所以默认值应该写在路由层，而不是让每个业务调用自己选。

Nano Banana Pro 是升级路线。它的价值不在“所有图片都更贵所以更好”，而在失败代价高的场景：图片里有可读文字、流程图、表格、复杂构图、品牌要求、客户交付或上线物料。只要一张坏图会让人返工、重审、重修设计，Pro 的价格差就可能比人工修复便宜。

价格和尺寸会直接改变路由

价格不是单纯的每张图数字。尺寸、实时性、批处理、失败重试次数都会改变最终成本。原版 Nano Banana 最便宜，但只适合 1024px 级别；Nano Banana 2 有最完整的尺寸梯子；Pro 的费用更高，是因为它面向更高风险的输出。

按 2026 年 4 月 20 日 Google 当前价格行整理：

第一条成本规则：不要只拿 1K 做比较。如果工作流大量生成小图，Nano Banana 2 的 0.5K 档很有意义；如果要 4K，原版 Nano Banana 直接出局；如果输出是最终品牌素材，Pro 的高价要和人工修图、审稿时间一起算。

第二条成本规则：把失败成本写进路由。便宜模型如果连续生成三张不可用图片，再加上人工检查，就不一定便宜。Pro 如果一次减少返工，反而可能是低总成本路线。批量非实时任务还可以走 Batch/Flex，把高分辨率或 Pro 任务放到异步队列里处理。

默认用 Nano Banana 2，再写清楚两个例外

最稳的产品规则不是“总用最新模型”，而是“默认 Nano Banana 2，然后写清楚降级和升级条件”。这样既有统一默认值，也不会把所有成本都推到 Pro。

默认使用 Nano Banana 2 的场景包括：博客配图、商品概念、应用内插画、轻量社交图、帮助中心截图式说明图、本地化图片、Web 背景和需要 1K 以上尺寸的常规素材。它足够通用，可以作为新流量入口。

降级到原版 Nano Banana 需要同时满足几个条件：1K 足够、没有重要文字、图片不需要复杂结构、失败后可以重试或直接丢弃。典型例子是内部占位图、低风险缩略图、旧系统的稳定批量任务。只要图片要被编辑审核、客户看见、或者承载说明信息，就不该轻易降级。

升级到 Pro 的触发条件应该更明确：提示词要求可读文字、图表结构、密集版式、多对象约束、品牌关键视觉、广告图、文档图、客户交付物，或者 Nano Banana 2 已经在某类提示上稳定失败。Pro 最适合做“少数高风险请求”的前置选择或失败后的命名升级，而不是隐形默认值。

生产环境先分类请求，再切模型 ID

模型字符串很好改，但盲目切换会让账单和输出都变得不可解释。生产路由应先判断请求类型，再选模型，再用选择理由检查结果。

一个可落地的顺序是：

1. 新图片生成流量先走 Nano Banana 2。
2. 提示词包含文字、图表、复杂版式、最终交付、品牌关键用途时，生成前直接升到 Pro。
3. 任务简单、1K、低风险、强成本敏感时，才降到原版 Nano Banana。
4. 不需要实时返回的大批量任务放进 Batch/Flex。
5. 用模型选择理由检查输出：Pro 看文字和结构，Nano Banana 2 看尺寸与总体质量，原版看是否满足低风险 1K 目标。

这一步能防止路由层变成“工程师喜好列表”。如果请求因为文字进入 Pro，就要检查文字是否可读；如果因为低风险进入原版，就要确认 1K 和简单画面确实够用。配额、429、项目限制应作为运维分支处理，不要因为限流就自动改用更贵模型。配额规划可以在模型路线确定后再看 Gemini API 速率限制指南。

代码里按模型 ID 路由，不按口头标签路由

安全的实现方式是让业务层使用内部路线名，再在一个集中位置映射到官方模型 ID。UI 文案、价格档位、服务商别名都不应该直接传给 API client。

python
from google import genai
from google.genai import types

client = genai.Client(api_key="GEMINI_API_KEY")

MODEL_BY_ROUTE = {
    "cheap_1k": "gemini-2.5-flash-image",
    "default": "gemini-3.1-flash-image-preview",
    "premium": "gemini-3-pro-image-preview",
}

def choose_image_route(job):
    if job.get("final_asset") or job.get("has_text") or job.get("diagram"):
        return "premium"
    if job.get("simple") and job.get("max_size") == "1k" and job.get("low_risk"):
        return "cheap_1k"
    return "default"

job = {
    "prompt": "Create a clean product release diagram with readable labels",
    "has_text": True,
    "diagram": True,
    "final_asset": False,
}

route = choose_image_route(job)
response = client.models.generate_content(
    model=MODEL_BY_ROUTE[route],
    contents=job["prompt"],
    config=types.GenerateContentConfig(response_modalities=["IMAGE"]),
)

模型专属配置也要放在同一个边界之后。某个尺寸、参数或输出设置只在某个模型可用，就要在选定路线后再应用，避免 fallback 继承不支持的配置。日志里至少记录路线、模型 ID、请求尺寸、价格档、升级触发条件和验证结果。这样财务能看懂成本，客服能追踪失败，工程能安全调路由。

已有管线什么时候迁移

如果旧管线用原版 Nano Banana，输出已经稳定并且用途简单，不必因为新模型出现就立刻迁移。先用真实 workload 做小样本测试，比较通过率、人工修复时间、重试次数和最终成本。

当管线需要更大尺寸、更强指令跟随、更统一的默认模型，或者同一业务里开始混入文字和复杂版式，默认路线应逐步迁到 Nano Banana 2。做法不是一次性全量切换，而是把一小部分流量切过去，观察可接受输出率和人工返工量，再扩大比例。

当 Nano Banana 2 在某类请求上反复失败时，把这类请求升到 Pro。触发条件要命名：文字失败、图表结构失败、品牌审核失败、最终素材返工多、复杂版式不稳定。这样 Pro 是质量工具，不是账单黑洞。只比较 Nano Banana 2 和 Pro 的升级价值时，可以继续看 Nano Banana Pro vs Nano Banana 2 对比。

常见问题

新 API 集成默认应该选哪一个？

默认选 Nano Banana 2，也就是 gemini-3.1-flash-image-preview。它在尺寸、能力和价格之间最平衡，适合大多数新图片生成流量。原版 Nano Banana 作为低风险 1K 例外，Nano Banana Pro 作为高质量例外。

Nano Banana Pro 什么时候值得加钱？

当图片包含必须可读的文字、图表、严密版式、品牌关键视觉、客户交付物或最终上线素材时，Pro 更值得。判断标准不是“更好看”，而是一张坏图会不会带来明显人工返工或上线风险。

原版 Nano Banana 还应该保留吗？

应该保留，但范围要窄。它适合简单、低风险、1024px 级别输出，尤其是旧链路、内部占位图、批量草图和缩略图。它不适合新建的混合尺寸、文字密集或高审稿要求工作流。

表里的价格是固定额度或账户承诺吗？

不是。价格是 2026 年 4 月 20 日核对的 Google API 价格行。实际项目额度、账号资格、速率限制和可用性可能因项目、地区、账单状态而变化，生产上线前仍要以当前 Google 控制台或 AI Studio 为准。

已有图片生成管线能无痛切模型吗？

通常可以，但前提是模型选择、提示词、尺寸和验证规则已经解耦。最安全的做法是使用内部路线名映射官方模型 ID，并把模型专属参数放在路线之后处理。这样升级到 Nano Banana 2 或 Pro 时，改的是路由规则，而不是整条图片生成管线。