---
title: "Nano Banana 2.1 API：模型 ID、價格、解析度與限制"
description: "Nano Banana 2.1 API 重點整理：模型 ID gemini-nano-banana-2.1、請求欄位、1K/2K/4K 尺寸、14 張參考圖片、價格與限制，資料來自 Google 官方文件。"
robots: "index, follow"
canonical: "https://potto.ai/zh-Hant/blog/nano-banana-2-1-api"
markdown: "https://potto.ai/zh-Hant/blog/nano-banana-2-1-api.md"
author: "Potto AI Team"
category: "AI images"
datePublished: "2026-10-11T00:00:00.000Z"
language: "zh-Hant"
dateModified: "2026-10-12T10:46:16.708Z"
---

# Nano Banana 2.1 API：模型 ID、價格、解析度與限制

Nano Banana 2.1 API 是 Google 的 Gemini API 模型 `gemini-nano-banana-2.1`，這是一款高效率的圖像生成與對話式編輯模型，你可以用文字提示詞呼叫，並可選擇搭配參考圖片。根據 Google 的 [Nano Banana 2.1 模型頁面](https://ai.google.dev/gemini-api/docs/models/gemini-nano-banana-2.1)，它會傳回 1K（預設）、2K 或 4K 圖片，最多接受 14 張參考圖片（最多 10 個物件與最多 4 個角色），並具備可設定的思考功能。Google 的標準價格為每張 1K 圖片 $0.0336、每張 2K 圖片 $0.0504，以及每張 4K 圖片 $0.113，而批次工作的價格為其一半。

本指南將整合所需的資訊集中在一處：模型 ID、要呼叫哪個端點、重要的請求欄位、輸出尺寸、參考圖片名額、價格、速率限制與批次工作。所有數字皆來自 Google 的官方文件，讀取日期為 2026-10-10。價格與限制可能變動，因此在編列預算或正式上線前，請先到 Google 的頁面確認。

Potto 並未提供公開 API。若要從自己的程式碼呼叫此模型，請直接使用 Google 的 Gemini API。如果你只想要圖片，Potto 網頁生成器中的 [Nano Banana 2.1](/zh-Hant/nano-banana-2-1) 頁面可讓你使用相同模型建立與編輯，無需撰寫請求。

## Nano Banana 2.1 API 快速總覽

| 項目 | Google 文件怎麼說 |
| --- | --- |
| 模型 ID | `gemini-nano-banana-2.1`（穩定版本使用相同 ID） |
| 輸入 | 文字、圖像、影片與 PDF |
| 輸出 | 圖像與文字 |
| 輸出解析度 | 1K（預設）、2K、4K；2.1 不支援 512px |
| 參考圖片 | 總計最多 14 張：最多 10 個物件與最多 4 個角色 |
| 思考層級 | `minimal`、`medium`（預設）、`high` |
| grounding | Google Web 與 Image Search |
| Batch API | 支援 |
| 不支援 | 函式呼叫、結構化輸出、快取、程式碼執行、URL context、Maps grounding、Live API、音訊生成 |
| 免費方案層級 | 不提供 |
| 標準圖像價格 | $0.0336（1K）、$0.0504（2K）、$0.113（4K） |
| 批次圖像價格 | $0.0168（1K）、$0.0252（2K）、$0.0567（4K） |

資料來源：Google 的模型頁面（最後更新 2026-10-06 UTC）與價格頁面，讀取於 2026-10-10。

![Nano Banana 2.1 API 請求流程：提示詞與參考圖片送到 Gemini API 模型，然後回傳一張圖像](https://potto.ai/blog/nano-banana-2-1-api/zh-Hant/nano-banana-2-1-api-request-flow.webp#1200x675)

## 什麼是 Nano Banana 2.1 API？

「Nano Banana」是 Google 在 Gemini 系列中的圖像生成與編輯模型的通俗名稱，而 Nano Banana 2.1 API 就是從程式碼取用其中一款模型的方式。沒有另外需要註冊的產品：你使用 Gemini API 金鑰，並在請求中指定模型 ID。Google 的圖像生成指南在 Nano Banana 名稱下列出五個模型，每個模型都有自己的 ID：

| 名稱 | 模型 ID |
| --- | --- |
| Nano Banana 2.1 | `gemini-nano-banana-2.1` |
| Nano Banana 2 Lite | `gemini-3.1-flash-lite-image` |
| Nano Banana 2 | `gemini-3.1-flash-image` |
| Nano Banana Pro | `gemini-3-pro-image` |
| Nano Banana（原版） | `gemini-2.5-flash-image` |

Google 的指南稱 2.1 是圖像生成與對話式編輯的主要高效率主力模型，並建議所有新專案採用。若想與 Pro 模型比較，請閱讀 [Nano Banana 2.1 與 Nano Banana Pro 的比較](/zh-Hant/blog/nano-banana-2-1-vs-nano-banana-pro)指南；本文則聚焦在 2.1 的整合。

Google 列出在 1K、2K 和 4K 下有更好的視覺品質與真實感，在 2K 與 4K 下修正了寬版與全景長寬比（1:4、4:1、1:8 和 8:1）的拼接瑕疵，改善文字算繪與資訊圖表版面準確度，並支援以 Google 網頁搜尋與圖片搜尋進行 grounding。文件並未公布基準測試分數，因此在將流程投入此模型前，請先測試你自己的提示詞。

## 該呼叫哪個端點？

呼叫 Interactions API。Google 的圖像生成指南在每個 Nano Banana 2.1 範例中都使用它：對 `https://generativelanguage.googleapis.com/v1beta/interactions` 發出 `POST` 請求，並在 `x-goog-api-key` 標頭中放入你的金鑰。Google 的 Interactions API 總覽指出，自 2026 年 6 月起，它已正式推出並建議用於所有新專案，且所有新模型、工具與代理功能都將在那裡推出。較舊的 `generateContent` API 被描述為舊版，但仍受到完整支援。

SDK 呼叫（`client.interactions.create`）需要 `google-genai` 或 `@google/genai` 版本 2.3.0 或更新版本。該總覽也將 Batch API、明確快取與自訂安全設定列為 Interactions 尚未提供的功能，因此批次價格意味著使用 `generateContent`，如批次章節所述。

## 送出第一個 Nano Banana 2.1 API 請求

最小的請求會指定模型，並將提示詞作為文字項目傳遞。Google 的指南展示了這個 REST 呼叫：

```bash
curl -s -X POST \
  "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "input": [
      {"type": "text", "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme"}
    ]
  }'
```

若要選擇結果的形式，請新增一個 `response_format` 物件。相同的欄位也出現在 Google 的 Python 範例中，其中輸出是從 `interaction.output_image` 讀取的：

```bash
-d '{
    "model": "gemini-nano-banana-2.1",
    "input": [{"type": "text", "text": "A cedar bottle on a linen cloth, soft window light"}],
    "response_format": {
      "type": "image",
      "mime_type": "image/jpeg",
      "aspect_ratio": "16:9",
      "image_size": "2K"
    },
    "generation_config": {"thinking_level": "medium"}
  }'
```

這些欄位的簡單說明：

| 欄位 | 說明 |
| --- | --- |
| `input` | 提示詞以 `{"type": "text", "text": ...}` 項目表示，再加上用於參考的 `{"type": "image", ...}` 項目 |
| `response_format.mime_type` | 在 Google 的範例中為 `image/jpeg` 或 `image/png` |
| `response_format.aspect_ratio` | 例如在 Google 的範例中為 `1:1`、`5:4` 或 `16:9` |
| `response_format.image_size` | `1K`、`2K` 或 `4K`，K 為大寫 |
| `generation_config.thinking_level` | `minimal`、`medium` 或 `high` |
| `previous_interaction_id` | 延續先前的互動，以進行多輪編輯 |

在 SDK 範例中，圖片會以 base64 編碼的形式出現在 `interaction.output_image.data` 中，而 Python 範例會在寫入檔案之前使用 `base64.b64decode` 進行解碼。該互動也帶有 `steps`，其中可能包含思考步驟和最終的 `model_output`。Google 的 REST 範例不會印出回應主體，因此在為原始 JSON 編寫解析器之前，請先檢查實際的回應。

## Nano Banana 2.1 輸出尺寸：1K、2K 與 4K

Nano Banana 2.1 提供三種輸出尺寸：1K、2K 與 4K，當你未設定 `image_size` 時，預設為 1K。Google 的價格頁面列出各尺寸消耗的圖片 token：1K 圖片為 1,120，2K 為 1,680，4K 為 3,780。

![Nano Banana 2.1 的 1K、2K 與 4K 輸出尺寸，以三個巢狀畫框呈現](https://potto.ai/blog/nano-banana-2-1-api/zh-Hant/nano-banana-2-1-output-sizes.webp#1200x675)

圖片生成指南中會導致實際錯誤的規則：

- **僅限大寫 K。** 小寫值如 `1k` 會被拒絕。
- **2.1 不支援 512px。** 較小的 512px（0.5K）尺寸屬於 Gemini 3.1 Flash Image，不屬於 Nano Banana 2.1。
- **長寬比。** 2.1 的範例使用 `1:1`、`5:4` 與 `16:9`。Google 的模型頁面將 `1:4`、`4:1`、`1:8` 與 `8:1` 列為寬幅與全景比例，這些比例在 2K 與 4K 下的拼接偽影已修復。本指南所閱讀的頁面並未列出 2.1 的完整比例清單，因此在你圍繞某個比例建構版面之前，請先測試你需要的確切比例。
- **像素尺寸。** Google 的指南並未發布 2.1 的像素表，因此如果你的版面需要固定尺寸，請測量傳回的檔案。

根據指南，Google 工具生成的每張圖片都包含 SynthID 浮水印。如果你會後製或裁切輸出，請將此納入考量。

在 1K 下調整提示詞，因為更大的尺寸無法修正薄弱的構圖或拼錯的字。如果你已經有一張滿意的成品，只需要更多像素，[圖片放大](/zh-Hant/image-upscaler) 可在不重新生成的情況下將其放大。

## 參考圖片：每次請求最多 14 張

Nano Banana 2.1 在單一請求中最多接受 14 張參考圖片，而且這個數量是所有類型加總。Google 的指南依模型拆分這些名額：

| 參考類型 | Nano Banana 2.1 |
| --- | --- |
| 物件（最終圖片中的高保真度） | 最多 10 |
| 角色（跨圖片一致性） | 最多 4 |
| 總計 | 最多 14 |

每個參考都是 `input` 清單中的另一個項目。在 Google 的 Python 範例中，圖片項目帶有 `"type": "image"`、以 base64 形式放在 `data` 中的圖片位元組，以及像 `image/png` 這樣的 `mime_type`，並放在含有提示詞的文字項目旁邊。

![Nano Banana 2.1 最多接受 14 張參考圖片，以物件與角色參考的網格呈現](https://potto.ai/blog/nano-banana-2-1-api/zh-Hant/nano-banana-2-1-reference-images.webp#1200x675)

這些名額的實用做法：給每張圖片一個任務，並在提示詞中說明（第一張圖片是產品形狀，第二張是調色盤）；為重複出現的臉孔重複使用同一張角色圖片；一次加入一張參考，因為更多參考並不保證每個細節都能保留下來。

## 思考與 grounding 設定

Nano Banana 2.1 支援三種思考層級，透過 `generation_config.thinking_level` 設定：`minimal`、`medium`（預設值）與 `high`。Google 的指南指出，Gemini 3 圖像模型預設開啟思考功能，且無法透過 API 停用；模型最多可產生兩張過渡思考圖像；思考 token 預設會計費。其他 Nano Banana 模型列出的層級不同（Nano Banana 2 列出 `minimal` 與 `high`），因此請勿跨模型複製設定。

Grounding 讓模型能針對時效性主題使用 Google 搜尋。在 Interactions API 中，你新增帶有 `google_search` 的 `tools`，而 `search_types` 設為 `["web_search", "image_search"]` 則要求網頁與圖像結果；Image Search grounding 僅適用於 Nano Banana 2.1 與 Gemini 3.1 Flash Image。Google 提醒，Image Search 結果必須連同其 `search_suggestions` 一起顯示，因此請將該顯示方式納入你的介面。

Grounding 另外計費：Google 的價格頁面提供每月 5,000 次免費搜尋請求，由 Gemini 3 與較新模型共用，之後每 1,000 次請求為 $14。發布含有 grounding 的圖像前，請先驗證當中的任何名稱、數字或日期。

## 以 previous_interaction_id 進行多輪編輯

若要變更你已經生成的圖片，請傳送第二個請求，並將 `previous_interaction_id` 設為第一個互動的 `id`，且只描述要變更的內容。Google 的範例會將資訊圖表的文字翻譯成西班牙文，同時保留其他元素不變。根據 Interactions API 總覽，`generation_config`、`tools` 和 `system_instruction` 的作用範圍僅限於單一互動，因此每一輪都要再次設定它們，而將 `store` 設為 `false` 會讓你無法使用 `previous_interaction_id`。若編輯時你想手動塗抹某個區域，使用 [AI 修圖](/zh-Hant/ai-image-editor) 會比用文字描述更容易。

## Nano Banana 2.1 API 價格

Google 以 token 計費 Nano Banana 2.1，而圖片輸出有其專屬費率。以下是取自 Gemini API 價格頁面的標準方案（付費方案層級）價格表，讀取日期為 2026-10-10：

| 項目 | 標準方案 | 批次 |
| --- | --- | --- |
| 輸入（文字、圖片、影片） | 每 1M token $1.50 | 每 1M token $0.75 |
| 輸出文字與思考 | 每 1M token $7.50 | 每 1M token $3.75 |
| 輸出圖片 | 每 1M 圖片 token $30.00 | 每 1M 圖片 token $15.00 |
| 一張 1K 圖片 | $0.0336 | $0.0168 |
| 一張 2K 圖片 | $0.0504 | $0.0252 |
| 一張 4K 圖片 | $0.113 | $0.0567 |
| 使用 Google 搜尋的 grounding | 每月 5,000 次免費請求，之後每 1,000 次 $14 | 未另行列出 |

每張圖片的價格，是將圖片 token 費率套用到上一節的 token 數量：1,120 token 以每百萬 $30 計算為 $0.0336。免費方案層級列出為不適用於此模型，因此每次呼叫都需要計費專案。

以規模來看，僅使用 Google 的圖片輸出價格：1,000 張圖片在 1K 時為 $33.60、2K 時為 $50.40、4K 時為 $113.00，或作為批次時 2K 為 $25.20。輸入 token（你的提示詞與任何參考圖片）、思考 token 與 grounding 請求會另外計費，因此在投入預算前，先測量一次範例執行。

## 速率限制與配額

Google 的速率限制頁面並沒有為 Nano Banana 2.1 列出數字。它說明限制的運作方式，並引導你前往 Google AI Studio 查看適用於你的專案與方案層級的數字。

頁面實際載明的內容：

- **維度。** 每分鐘請求數（RPM）、每分鐘輸入 token 數（TPM）與每日請求數（RPD）；影像生成模型另有每分鐘圖片數（IPM）。超過任一維度都會觸發錯誤。
- **範圍。** 限制適用於每個專案，而非每個 API 金鑰，每日配額會在太平洋時間午夜重置。
- **方案層級。** Free 需要有效的專案，Tier 1 需要已連結的帳單帳戶，Tier 2 需要累計 $100 的付費支出加上 3 天，Tier 3 則需要 $1,000 加上 30 天。升級會自動進行。
- **支出上限。** 以支出為基準的限制適用於滾動的 10 分鐘時間窗，達到任一上限會傳回 `429 RESOURCE_EXHAUSTED` 錯誤。

一次發出大量平行請求的迴圈，可能在每日配額用完之前就早早觸發 429，因此請加入含退避的重試、限制並行數，並將大型離線工作透過 Batch API 送出。

模型頁面也列出 131,072 個輸入 token 與 32,768 個輸出 token，且不支援 Flex 或 Priority 推論。

## Nano Banana 2.1 的 Batch API

模型頁面將 Batch API 列為支援項目，而 Google 的價格頁面將批次圖片輸出定為標準價格的一半：每 1K 圖片 $0.0168、每 2K 圖片 $0.0252，每 4K 圖片 $0.0567。Batch API 指南將目標周轉時間設為 24 小時，不過大多數情況下會短得多。換來的是以等待時間換取價格與更高的速率限制，這適合目錄更新、提示詞測試與大量變化，而不是有人正在等待的介面。

Batch API 指南的細節：內嵌請求總計必須低於 20 MB，較大的工作則使用 JSONL 檔案（最多 2 GB），每行一個請求，並搭配你定義的 `key`。工作會經歷 `JOB_STATE_PENDING`、`JOB_STATE_RUNNING` 與 `JOB_STATE_SUCCEEDED`，或以失敗、已取消或 `JOB_STATE_EXPIRED` 結束；若工作處於待處理或執行中超過 48 小時就會過期。速率限制頁面列出 100 個並行批次請求與 20 GB 的檔案儲存空間，外加各方案層級的排隊 token 限制。

有一個要注意的地方：指南指出批次處理僅適用於 `generateContent` API，而其圖片範例使用 `responseModalities` 設為 `["TEXT", "IMAGE"]`，並搭配不同的 Nano Banana 模型 ID。它沒有 `gemini-nano-banana-2.1` 的範例，因此在你提交數千個請求之前，請先用這個模型 ID 執行小型測試批次。實際上，互動式編輯執行於 Interactions API，而大量離線生成則執行於 `generateContent` 批次。

## 從舊模型遷移至 Nano Banana 2.1

Google 的價格頁面已將初代 Nano Banana（`gemini-2.5-flash-image`）標示為已淘汰，關閉日期為 2026 年 10 月 2 日；圖像生成指南則建議新專案採用 Nano Banana 2.1。

更換模型 ID 時，請留意以下差異。2.1 的思考層級列出 `minimal`、`medium` 和 `high`，而 3.1 Flash Image 列出的是 `minimal` 和 `high`。512px 尺寸存在於 3.1 Flash Image，但 2.1 沒有，因此請指定 1K，並在自己的端調整尺寸。Image Search grounding 在 2.1 與 3.1 Flash Image 上都能運作，而 Flash Lite 沒有搜尋 grounding。2.1 不支援函式呼叫或結構化輸出，因此請把任何會產生 JSON 的步驟移到文字模型。請以上述 2.1 的費率重新計算成本預估，接著把已儲存的提示詞送進新模型執行，並將結果與舊模型比較，因為即使提示詞完全相同，更換模型仍會改變風格與文字渲染。

## 不使用 API 也能用 Nano Banana 2.1

如果你要的是成品圖片，而不是串接整合，用瀏覽器會更簡單。Potto 的 [AI 畫圖](/zh-Hant/ai-image-generator) 提供 Nano Banana 2.1，支援 HD、2K 與 4K 輸出、最多 10 張參考圖片，以及 PNG 或 JPEG 檔案。由於 Potto 沒有公開 API，因此這僅限網頁操作流程。

Potto 以點數計算圖片價格，並在你確認前顯示於「生成」按鈕上。Nano Banana 2.1 在 HD 下每張圖片 12 點、2K 為 17 點、4K 為 38 點，失敗的請求會退還點數。點數是 Potto 自有的計價單位，並非 Google 美元價格的換算，所以別把兩者當成同一種貨幣來比較。[Potto AI 價格](/zh-Hant/pricing) 頁面列出各方案，[AI 模型](/zh-Hant/ai-models) 頁面則比較創作者中所有圖片模型，包括 Nano Banana 與 Nano Banana Pro。

這些工作流程與 API 相呼應：[文字生成圖片](/zh-Hant/text-to-image) 是只含文字項目的請求，[圖生圖](/zh-Hant/image-to-image) 則會像 `input` 中的 image 項目一樣加入你自己的圖片，AI 角色生成器鎖定反覆出現的角色，圖片範本則提供現成的說明供你調整。

![Nano Banana 2.1 API 或網頁生成器：程式碼路徑與瀏覽器路徑，兩者都導向同類型圖片](https://potto.ai/blog/nano-banana-2-1-api/zh-Hant/nano-banana-2-1-api-vs-web-generator.webp#1200x675)

## API 或網頁生成器：該用哪一個？

當圖片是在你自己的產品內或按排程產生時，請使用 Gemini API：例如為每個商品刊登渲染不同變體的店面、以批次價格執行的夜間工作，或讓使用者輸入提示詞的應用程式。金鑰、重試、儲存與帳單都由你掌控，而且你能取得 Google 的完整參數集。

當圖片是由真人製作時，請使用網頁生成器：例如活動海報、產品照、簡報用的吉祥物。不必管理金鑰，也不必解析回應，而且每次生成前都會先顯示價格。你也可以先在瀏覽器中探索提示詞，之後再把勝出的用語搬進 API 呼叫。

## 常見問題

### 什麼是 Nano Banana 2.1 API？

Nano Banana 2.1 API 是透過 Gemini API 呼叫 Google 的 `gemini-nano-banana-2.1` 圖片模型的方式。它接受文字、圖片、影片或 PDF 輸入，回傳圖片與文字，並支援 1K、2K 與 4K 輸出、最多 14 張參考圖片、可設定的思考，以及 Google 搜尋 grounding。它不是獨立產品：你使用 Gemini API 金鑰，並在請求中指定模型 ID。

### Nano Banana 2.1 的模型 ID 是什麼？

模型 ID 是 `gemini-nano-banana-2.1`。Google 的模型頁面指出，穩定版使用相同 ID，因此不需要版本後綴。其他 Nano Banana 模型有各自的 ID，例如 Nano Banana 2 的 `gemini-3.1-flash-image`，所以每次更換模型時都要確認 ID。

### Nano Banana 2.1 API 要多少錢？

以標準價格計算，Google 每張 1K 圖片收費 $0.0336，每張 2K 圖片 $0.0504，每張 4K 圖片 $0.113，另外還會依輸入與思考的 token 收費。批次工作的費用減半：$0.0168、$0.0252 與 $0.0567。這些數字來自 Google 的 Gemini API 價格頁面，讀取日期為 2026-10-10，而免費方案層級列為不適用於此模型。

### Nano Banana 2.1 可以使用多少張參考圖片？

一個請求最多 14 張：最多 10 張物件圖片與最多 4 張人物圖片。Google 會跨類型合計總數，因此即使兩項上限都用滿，一個請求也不能超過 14 張。在提示詞中讓每張參考圖片各司其職，並在結果中檢查你在意的細節。

### Potto 有 Nano Banana 2.1 API 嗎？

沒有。Potto 不提供公開 API。你可以在 Potto 的網頁生成器中使用 Nano Banana 2.1，HD 每張圖片 12 點數，2K 為 17 點數，4K 為 38 點數。想從程式碼呼叫此模型的開發者，應使用 Google 的 Gemini API，並指定模型 ID `gemini-nano-banana-2.1`。

### Nano Banana 2.1 API 的速率限制是什麼？

Google 並未在其速率限制頁面上公布此模型的數字。限制以每分鐘請求數、每分鐘輸入 token 數、每日請求數，以及（針對圖片模型）每分鐘圖片數來衡量，並依專案適用，且取決於你的使用方案層級。請在 Google AI Studio 中開啟速率限制檢視畫面，查看適用於你帳戶的數字。

### Nano Banana 2.1 可以使用 Batch API 嗎？

可以。Google 在模型頁面將 Batch API 列為支援項目，批次圖片的價格為標準價格的一半，目標處理時間為 24 小時。批次處理僅適用於 `generateContent` API，而非 Interactions API，且 Google 的批次圖片範例使用不同的 Nano Banana 模型 ID，因此請先以 `gemini-nano-banana-2.1` 測試小型批次。

## 資料來源

所有資料來源皆於 2026-10-10 閱讀。價格、限制與模型細節均為 Google 所有，且可能變動。

- [Gemini Nano Banana 2.1 模型頁面](https://ai.google.dev/gemini-api/docs/models/gemini-nano-banana-2.1)，Google AI for Developers。
- [Gemini 圖像生成（Nano Banana）](https://ai.google.dev/gemini-api/docs/image-generation)，Google AI for Developers。
- [Gemini Developer API 價格](https://ai.google.dev/gemini-api/docs/pricing)，Google AI for Developers。
- [Gemini API 速率限制](https://ai.google.dev/gemini-api/docs/rate-limits)，Google AI for Developers。
- [Batch API](https://ai.google.dev/gemini-api/docs/batch-api)，Google AI for Developers。
- [Interactions API 總覽](https://ai.google.dev/gemini-api/docs/interactions)，Google AI for Developers。