2026年10月11日 Nano Banana 2.1 API：模型 ID、價格、解析度與限制 作者 Potto AI Team ·
Nano Banana 2.1 API 重點整理：模型 ID gemini-nano-banana-2.1、請求欄位、1K/2K/4K 尺寸、14 張參考圖片、價格與限制，資料來自 Google 官方文件。
Nano Banana 2.1 API 是 Google 的 Gemini API 模型 gemini-nano-banana-2.1，這是一款高效率的圖像生成與對話式編輯模型，你可以用文字提示詞呼叫，並可選擇搭配參考圖片。根據 Google 的 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 頁面可讓你使用相同模型建立與編輯，無需撰寫請求。
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（預設）、highgrounding 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？ 「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.1Nano Banana 2 Lite gemini-3.1-flash-lite-imageNano Banana 2 gemini-3.1-flash-imageNano Banana Pro gemini-3-pro-imageNano Banana（原版） gemini-2.5-flash-image
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 呼叫：
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 讀取的：
-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_size1K、2K 或 4K，K 為大寫generation_config.thinking_levelminimal、medium 或 highprevious_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。
僅限大寫 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 下調整提示詞，因為更大的尺寸無法修正薄弱的構圖或拼錯的字。如果你已經有一張滿意的成品，只需要更多像素，圖片放大 可在不重新生成的情況下將其放大。
參考圖片：每次請求最多 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，並放在含有提示詞的文字項目旁邊。
這些名額的實用做法：給每張圖片一個任務，並在提示詞中說明（第一張圖片是產品形狀，第二張是調色盤）；為重複出現的臉孔重複使用同一張角色圖片；一次加入一張參考，因為更多參考並不保證每個細節都能保留下來。
思考與 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 修圖 會比用文字描述更容易。
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 畫圖 提供 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 價格 頁面列出各方案，AI 模型 頁面則比較創作者中所有圖片模型，包括 Nano Banana 與 Nano Banana Pro。
這些工作流程與 API 相呼應：文字生成圖片 是只含文字項目的請求，圖生圖 則會像 input 中的 image 項目一樣加入你自己的圖片，AI 角色生成器鎖定反覆出現的角色，圖片範本則提供現成的說明供你調整。
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 所有，且可能變動。
製作下一支產品發表影片。 將感興趣的想法轉成自己的影片或圖片。準備截圖、主題或提示詞，開始創作。
