# Nano Banana API Key 指南 2026：官方 Gemini 接入、模型选择与可运行代码

> Nano Banana API key 本质上是通过 Google AI Studio 管理的 Gemini API key。先拿到 key，再把 key、账单、项目配额、免费说法和第三方 gateway key 分清楚。

- URL: https://blog.laozhang.ai/zh/posts/nano-banana-ai-image-generation-api
- Published: 2026-03-29
- Updated: 2026-07-01
- Author: AI Free API Team (https://blog.laozhang.ai/zh/about)
- Category: API 指南
- Tags: Nano Banana API, Gemini API, 图片生成, Google AI, Nano Banana 2, Nano Banana Pro

---
如果你现在要找 **官方 Nano Banana API key**，正确入口是 **Google AI Studio 里的 Gemini API key**。这个 key 用来认证 Gemini API 请求；它不是单独的 Nano Banana 账号，不等于免费图像输出，也不是第三方 gateway 自己发的 key。

Google 当前文档已经把 **Interactions API** 标成通用可用，并建议用它获取最新 Nano Banana 模型与能力；同一页仍然可以切到 generateContent 版本。无论你选哪一种请求形状，key、账单、项目配额和模型选择规则都一样。截至 **2026 年 7 月 1 日**，Gemini API 里的 Nano Banana 家族包括 `gemini-3.1-flash-lite-image`、`gemini-3.1-flash-image`、`gemini-3-pro-image` 和旧路线 `gemini-2.5-flash-image`。

下文中所有 model ID、价格、key 行为与项目配额，都已经在 **2026 年 7 月 1 日** 对照 Google 当前开发者文档与定价页重新核实。

![官方 Nano Banana API 路线图，突出 Gemini API 与 AI Studio](https://blog.laozhang.ai/posts/zh/nano-banana-ai-image-generation-api/img/cover.png)

## TL;DR

先给最短可用答案。

| 你的真实任务 | 先从哪里开始 | 为什么 | 最大注意点 |
| --- | --- | --- | --- |
| 你要用官方 Google 图像 API | **Gemini API + Nano Banana 2** | 这是 Google 当前高效率、最适合做默认值的图像路径 | 当前 图像 API 是付费合同 |
| 你要更高保真成片、更强文字渲染或更复杂视觉推理 | **Nano Banana Pro** | 这是更高阶的专业图像层 | 更贵，而且应该是 override，不该当默认 |
| 你想先在 Google 自己的界面里试提示词 | **AI Studio** | 还是同一套官方技术栈，只是更适合先验证 | Google 明确说明在 AI Studio 里用 Nano Banana 2 需要 paid API key |
| 你只是想在消费端做图 | **Gemini Apps 或 AI Mode** | 不写代码也能直接生成和编辑 | 这些是消费端合同，不是 API 合同 |
| 你需要 OpenAI 兼容调用或多厂商统一计费 | **可选 gateway / wrapper** | 这种基础设施需求确实可能更方便 | 但它必须放在理解官方路径之后 |

真正有用的一句话是：**把“Nano Banana API”理解成 Gemini API 问题，而不是去找一个神秘的 Nano Banana 官网入口。**

## Nano Banana API 现在到底指什么

Google 当前的 image generation 文档把 **Nano Banana** 定义为 Gemini 的原生图像生成能力，而不是单一 surface。实际落到 API 语境里，它现在对应的是一个小型家族：

| 家族名称 | 官方 model ID | 当前角色 |
| --- | --- | --- |
| Nano Banana 2 Lite | `gemini-3.1-flash-lite-image` | 只需要 1K、极低延迟和低成本时的 Lite 路线 |
| Nano Banana 2 | `gemini-3.1-flash-image` | 质量、4K、文字渲染、编辑和吞吐更均衡的默认 API 起点 |
| Nano Banana Pro | `gemini-3-pro-image` | 更高保真、更适合专业资产与复杂文字渲染的上位层 |
| Nano Banana | `gemini-2.5-flash-image` | 更早的低延迟快路径 |

这里最容易被讲乱。Nano Banana API 这个名字表面看上去像是一个单独的“产品页”、一个账号入口，以及一个显然该选的模型。但 Google 现在已经不是这样描述它了。当前更准确的结构是 **家族选择 + surface 选择**：

- 你到底需要家族里的哪一个版本
- 你到底要的是官方 API、官方测试 UI，还是消费端入口

第二个必须纠正的点，是 **生成图片本身已经是 Gemini 请求/响应合同的一部分**，而不是藏在某个别的 Google 产品之后的黑箱。当前 image generation 文档已经直接给出了请求形状、图生图编辑、宽高比控制、图像尺寸、搜索 grounding 工具等能力。Google 还明确写到，**所有生成图片都带 SynthID 水印**。如果你的产品需要考虑 AI 来源标记或可追踪性，这一点并不次要。

如果你的真实问题比 API 更宽，你想看 Gemini、AI Mode 与 Google 各个入口之间的整体关系，可以继续读我们的 [Nano Banana AI 图片生成器指南](https://blog.laozhang.ai/zh/posts/nano-banana-ai-image-generator)。这条 API 路线更窄：只回答 **官方 API 应该怎么接**。

## 哪条是官方 API 路线，哪条不是

最容易把人带乱的做法，就是把 **Gemini Apps、AI Mode、AI Studio、Gemini API 和 wrapper** 全部放进同一个桶里。它们彼此相关，但绝不是同一个合同。

![把消费端、官方 API 与可选网关分开的 Nano Banana 三路访问图](https://blog.laozhang.ai/posts/zh/nano-banana-ai-image-generation-api/img/route-boundary-map.png)

**Gemini API** 才是官方程序化接入路径。只要你的应用需要调用 Interactions API 或 generateContent、发送提示词或输入图片、接收 image output，或者控制宽高比和图像尺寸，这就是答案。

**Google AI Studio** 是围绕同一技术栈的官方测试与开发界面。它非常适合在真正写代码前先试提示词、看模型行为、观察返回结果。Google 在 2026 年 2 月 26 日发布 Nano Banana 2 的官方博客里，还明确点出一个很多文章都没写清的事实：**在 Google AI Studio 里使用 Nano Banana 2，需要 paid API key。** 这意味着 AI Studio 是官方开发者 UI，而不是绕开 图像定价的免费入口。

**Gemini Apps** 和 **AI Mode** 当然都是真实产品，但它们属于消费端路径，不是 API 问题的直接答案。Gemini Apps Help 会区分 Nano Banana 与 Nano Banana Pro 在日常使用和高级输出上的分工；AI Mode Help 也会单独列图片创建限制，以及 Pro 在信息图/图表上的特殊定位。这些信息在你作为用户做选择时很重要，但它们 **不会改变官方 API 合同是什么**。

**Wrapper 和 gateway** 是另外一层基础设施选择。如果你的目标非常明确，比如 OpenAI 兼容调用、多模型统一账单、多厂商路由或支付层替代，它们当然可能有价值。但那是第二层判断，不是第一层。只要某个页面一上来就把 gateway 写成 Nano Banana 的定义，它给你的起点就已经错了。

最简洁的路由规则就是：

- 你要写代码，用 **Gemini API**
- 你要先在官方界面试提示词，用 **AI Studio**
- 你根本不是在问 API，而是在找消费端入口，用 **Gemini Apps** 或 **AI Mode**
- 你只有在能明确说出基础设施理由时，才该用 **gateway**

## 默认先用 Nano Banana 2，Lite 和 Pro 都要有理由

这是最值得提前做清楚的模型判断：默认先用 Nano Banana 2；只有在 1K 成本/速度是唯一核心约束时才下探到 Lite；只有在质量问题明确时才上 Pro。

Google 当前的 image generation docs 把 **Nano Banana 2** 描述为 Pro 的高效率对应层，适合速度和高吞吐的开发者使用场景。Google 自己在 2026 年 2 月的 rollout 博文里甚至直接把 Nano Banana 2 称为 **“our best image generation and editing model”**。对一篇 API 指南来说，这意味着你不该因为“Pro 听起来更高级”就把它当成自动默认值。

![用决策板展示 Nano Banana 2 Lite、Nano Banana 2 与 Nano Banana Pro 的模型选择、官方价格、免费层边界和验证日期](https://blog.laozhang.ai/posts/zh/nano-banana-ai-image-generation-api/img/model-price-chooser.png)

更适合先用 **Nano Banana 2** 的情况：

- 你正在做第一版集成
- 你更看重迭代速度和价格效率
- 你预期会有明显吞吐量
- 你想用一个最稳妥的默认模型覆盖大多数图像生成和编辑任务
- 你还说不出一个明确的 Pro 级理由

更适合切到 **Nano Banana Pro** 的情况：

- 文字渲染质量是结果成败的核心
- 图片本身是最终资产，而不是过渡草稿
- 你需要模型在复杂视觉指令上做更强的推理
- 任务高度依赖图表、排版结构，或对品牌级精度非常敏感

而 **Nano Banana**（`gemini-2.5-flash-image`）仍然有自己的位置：

- 你已经有工作负载围绕这条旧快路径调好
- 你确实想要低延迟，而不是 Nano Banana 2 的默认行为

真正重要的细节是：这不是一个简单的“画质梯子”。它是一个 **工作负载匹配** 问题。Nano Banana 2 不是 Pro 的“廉价版”，而是 Google 现在官方叙事里的主流默认 API 起点。Pro 是更高成本的 override。这个判断规则，比很多 wrapper 页面上那种含糊的“想要更好画质就上 Pro”有用得多。

如果你在做完这层判断后，还想看更细的 workload 对比，可以继续读我们的 [Nano Banana Pro vs Nano Banana 2 对比](https://blog.laozhang.ai/zh/posts/nano-banana-pro-vs-nano-banana-2)。当前 setup 路线不做全面对比，只负责帮你先走上正确起点。

## Quickstart：先拿 key，再选 Interactions API 或 generateContent

官方路径实际上比很多第三方教程写得更短。

### 1. 先拿到 Gemini API key

去 **Google AI Studio** 创建 key 即可。Google 让 key 的创建本身很容易，但这不应该被误读成“当前图像输出是免费合同”。每个 Gemini API key 都关联一个 Google Cloud project；新 AI Studio key 会按 auth key 创建，长期 dormant 的 unrestricted key 可能被 block。按照当前图像模型的定价页，正确理解应该是：

- **创建 key 这一步很容易**
- **当前 图像模型本身是付费 API 路线**

### 2. 安装当前官方 SDK

Google 当前 libraries 页面推荐的是 **Google GenAI SDK**，而不是更早的旧版 Gemini 客户端库。

```bash
# JavaScript / TypeScript
npm install @google/genai

# Python
pip install -U google-genai
```

如果你看到还在用 `google-generativeai` 的老示例，请把它当成历史代码，而不是现在最优路径。

### 3. 发出最小可用图像请求

新集成优先看官方 Interactions API 页面；如果你维护的是 generateContent 形状，下面这个兼容示例仍然能帮你验证 key、model ID、返回图片 bytes 和保存逻辑。对于新集成，先用 Nano Banana 2：

```javascript
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.1-flash-image",
  contents: "Create a clean editorial illustration of a robot sketching a website wireframe.",
  config: {
    responseModalities: ["Image"],
    responseFormat: {
      image: {
        aspectRatio: "16:9",
        imageSize: "2K",
      },
    },
  },
});

for (const part of response.candidates[0].content.parts) {
  if (part.inlineData) {
    fs.writeFileSync("output.png", Buffer.from(part.inlineData.data, "base64"));
  }
}
```

Python 版本的逻辑完全一致：

```python
import os
from google import genai
from google.genai import types

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-3.1-flash-image",
    contents="Create a clean editorial illustration of a robot sketching a website wireframe.",
    config=types.GenerateContentConfig(
        response_modalities=["Image"],
        response_format={
            "image": {
                "aspect_ratio": "16:9",
                "image_size": "2K",
            }
        },
    ),
)

for part in response.parts:
    if part.inline_data is not None:
        part.as_image().save("output.png")
```

如果你想直接验证原始 HTTP 形状，官方 REST 请求也很短：

```bash
curl -X POST \
  "https://generativelanguage.googleapis.com/v1/models/gemini-3.1-flash-image:generateContent" \
  -H "x-goog-api-key: ${GEMINI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [
        {"text": "Create a clean editorial illustration of a robot sketching a website wireframe."}
      ]
    }],
    "generationConfig": {
      "responseModalities": ["Image"],
      "responseFormat": {
        "image": {
          "aspectRatio": "16:9",
          "imageSize": "2K"
        }
      }
    }
  }'
```

切到 Pro 的方式其实非常无聊，这反而是好事：保留同样的请求形状，把 model 改成 `gemini-3-pro-image` 就够了。也正因为如此，“先上 Nano Banana 2，确定有理由再升到 Pro” 才是最实用的工作流。你不用为了测试上位层就重写整套集成。

![展示从 API key 到客户端再到 generateContent 与图像输出的官方请求流程图](https://blog.laozhang.ai/posts/zh/nano-banana-ai-image-generation-api/img/first-request-flow.png)

## 在你围绕 wrapper 设计系统之前，官方 API 里有哪些关键能力

官方 Gemini 路线值得先被当作基线，不只是因为它“更官方”，还因为它本身已经比很多 gateway 落地页写得更完整。

**图像编辑是原生能力。** 当前 image-generation docs 展示的是 text-and-image-to-image 工作流，而不是只支持 prompt 生图。如果你的产品要做编辑，而不是单次出图，这一点很关键。

**宽高比和图像尺寸可以显式控制。** 官方 API 支持 `responseFormat.image.aspectRatio`。对当前 图像模型，Google 也明确给出了从 `0.5K` 到 `4K` 的图像尺寸文档。这意味着你可以在自己产品里明确管理成本和延迟，不用被迫让所有请求都走同一尺寸。

**搜索 grounding 已经在官方栈里。** image-generation docs 现在展示了把 `google_search` 工具接到图像生成上的方式。这对图表、天气可视化、需要当前事实支撑的信息图尤其有价值。当然，这也不是“免费魔法”。Google 的定价页把 search grounding 当成单独的计费层，超过共享免费额度后会产生额外费用。

**SynthID 已经由平台处理。** 如果你的产品要处理 AI 溯源、标记或合规呈现，这件事比很多 gateway 页承认的重要得多。Google 明确写到，所有生成图片都包含 SynthID 水印。

如果你先通过 wrapper 页面认识 Nano Banana，这些能力很容易被盖过去。但它们才是你决定“官方路线上限够不够高”的关键。

## 价格与免费边界：最容易被写混的一段

大多数关于 Nano Banana API 的错误信息，都是在这里开始跑偏的。

当前 **Gemini Developer API 定价页** 对这些图像输出路线都明确标着 **`Free Tier: Not available`**。截至 **2026 年 7 月 1 日**，官方付费价格如下：

| 模型 | Standard 定价 | Batch / Flex 定价 |
| --- | --- | --- |
| Nano Banana 2 Lite（`gemini-3.1-flash-lite-image`） | `$0.0336 / 1K` | `$0.0168 / 1K` Batch |
| Nano Banana 2（`gemini-3.1-flash-image`） | `$0.045 / 0.5K`、`$0.067 / 1K`、`$0.101 / 2K`、`$0.151 / 4K` | `$0.022 / 0.5K`、`$0.034 / 1K`、`$0.050 / 2K`、`$0.076 / 4K` |
| Nano Banana Pro（`gemini-3-pro-image`） | `$0.134 / 1K-2K`、`$0.24 / 4K` | `$0.067 / 1K-2K`、`$0.12 / 4K` |

只要你记住这张表，很多排名页就会立刻暴露出它们在混合同：

- 免费创建 key
- AI Studio 的试用语言
- Gemini 或 AI Mode 的消费端额度
- 更早期或不相关的 free tier 叙事

这些根本不是一回事。

消费端 surface 自己当然有规则，而且会按账号、地区、计划和产品功能变化。那些限制只适合判断个人使用入口，不能拿来推导 API 计费、项目额度或开发者集成权限。

如果你的真实问题是“Nano Banana API 到底多少钱”，那就继续读我们的 [Nano Banana 2 API 定价指南](https://blog.laozhang.ai/zh/posts/nano-banana-2-api-pricing-guide) 和 [Gemini 3 Pro Image API 定价指南](https://blog.laozhang.ai/zh/posts/gemini-3-pro-image-api-pricing)。当前 setup 路线优先解决路由与接入，不做完整价格建模。

## 30 秒内做决定

如果你只想要最小决策树，就记住下面几句：

**要做新的官方集成，就用 Gemini API + Nano Banana 2。**

**只有当你能明确说出任务为什么更依赖文字渲染、画面保真或专业资产质量时，才切到 Nano Banana Pro。**

**想先在 Google 自己的界面里试提示词，就用 AI Studio。**

**如果你真正要解决的是消费端使用，不是在问 API，那就去 Gemini Apps 或 AI Mode。**

**如果你需要 wrapper，请先说清楚基础设施理由，比如 OpenAI 兼容调用或多厂商统一计费。不要让 wrapper 反过来定义产品本身。**

这就是当前这个关键词最干净、最可执行的答案。

## 常见问题

**官方 Nano Banana API 到底是什么？**  
它对应的是 Gemini 的原生图像生成家族，通过 Gemini API 和 Google AI Studio 暴露出来，而不是一个独立的 Nano Banana 开发者产品。

**我应该先用哪个模型？**  
默认先从 `gemini-3.1-flash-image` 开始。只有当 1K 成本和速度是核心约束时才下探到 `gemini-3.1-flash-lite-image`；只有当文字渲染、复杂版式、4K 或专业资产质量真的卡住结果时，才升到 `gemini-3-pro-image`。

**Nano Banana Pro 的官方 model ID 是什么？**  
`gemini-3-pro-image`。

**Nano Banana API 是免费的吗？**  
按照当前价格页，图像模型本身不提供 free tier 图像输出。消费端产品额度和 AI Mode 使用上限是另外的合同。

**我该用 AI Studio 还是 Gemini API？**  
两者一起用最合理：AI Studio 用来创建 key 和做官方提示词验证，Gemini API 用来接到你的应用里。新集成优先看 Interactions API；维护旧示例或旧代码时仍然要能读懂 generateContent。

**AI Mode 算 API 的一部分吗？**  
不算。AI Mode 是 Search 里的消费端 surface，有自己的图像限制和产品行为。

**API 支持图像编辑，不只是 text-to-image 吗？**  
支持。Google 的 image-generation 文档里已经有官方的图生图工作流。

**生成图片会带水印吗？**  
会。Google 说明所有生成图片都包含 SynthID 水印。

**如果我需要 gateway 额外提供的东西怎么办？**  
按现在的能力范围看，官方 Gemini API 已经覆盖了多数团队真正需要的高价值控制项：模型选择、图像编辑、宽高比、图像尺寸和搜索 grounding。只有在这些还不够时，gateway 才应该被当成明确的基础设施选择，而不是默认起点。