如何使用 Nano Banana Pro/Nano Banana 2 API —— 開發者逐步指南

如果您搜尋了「Nano Banana Pro API」，首先會讓人感到困惑的就是這個名稱。產品名稱是 Nano Banana Pro。您在程式碼中實際使用的 API 名稱是 gemini-3-pro-image. 一旦這一點釐清了，其餘的設定就沒那麼令人費解了。.

當畫面需要保持整體一致性時，請使用 Nano Banana Pro：例如需呈現可讀性文字、產品細節、品牌元素、在地化版面配置，或是包含大量細微限制的視覺簡報。若您仍在針對同一個創意反覆嘗試十種版本，建議先從 Nano Banana 2 開始，待方向確定且值得投入更多資源時，再升級至 Pro 版本。.

如果您的團隊仍在構思提示語，而非推出應用程式，, GlobalGPT 的 Nano Banana Pro 工作區 這是一個實用的平台，讓開發人員在正式整合 API 之前，能先比較各種輸出結果。這是一種富有創意的流程捷徑，但不能取代 Google 的 API 控制台、計費系統、日誌或企業級管理功能。.

快速回答

若要透過 API 使用 Nano Banana Pro，請建立一個 Google AI Studio 或 Google Cloud 專案、產生 Gemini API 金鑰、安裝 Google Gen AI SDK，然後呼叫 gemini-3-pro-image. 先從一個純文字轉圖像的請求開始。如果您在建置 API 之前仍需先檢查存取權限，那麼 Gemini 3 Pro 免費試用版操作指南 是一本值得一讀的輔助讀物。.

Nano Banana Pro API 究竟是什麼

Nano Banana Pro 是 Google 在 Gemini 影像系列中的一款頂級原生影像生成模型。在開發者文件中，Google 將其命名為 雙子座3號專業版圖像. 這就是為什麼型號字串與行銷名稱看起來不同。.

該 API 能夠根據文字生成圖片、使用一張或多張參考圖片，並依照書面指示編輯現有圖片。這使其在產品模型、廣告變體、圖表、在地化創意內容，以及圖片中的文字必須保持可讀性的圖片工作流程中十分實用；至於無程式碼探索方面，該 GlobalGPT 圖像生成器 這是先測試創意方向的較容易的場所。.

Nano Banana Pro 對比 Nano Banana 2

選擇的重點不在於哪個名稱聽起來比較新穎，而在於你目前的工作進度。Pro 適用於仔細的修訂階段；Nano Banana 2 則適用於雜亂的草稿循環；若你需要的是那條更快的路徑，請閱讀 Nano Banana 2 免費試用指南 在您以 Pro 為核心設計整個工作流程之前。.

使用實際的入口點設定 API

若要開發原型，Google AI Studio 通常是最快捷的途徑。若要開發企業應用程式，請使用貴團隊已信賴的 Google Cloud 設定，特別是當您需要共用帳單、存取控制、日誌記錄或 Vertex AI 治理功能時。如果存取決策確實取決於 Google 方案層級，請比較以下內容中的權衡取捨： Google AI Plus 與 Pro 版本對比指南 在將 API 設定視為唯一問題之前。.

公開文件是最簡潔明瞭的第一站。它能讓您確認自己是否身處 Nano Banana 影像生成頁面、檢查該頁面是否採用建議的 Interactions API 路徑，並從該處跳轉至 API 金鑰或 AI Studio 的入口點。.

1. 建立或開啟一個 Google AI Studio 或 Google Cloud 專案。.
2. 建立一個 Gemini API 金鑰。.
3. 將金鑰儲存為伺服器端的環境變數。.
4. 在您的後端專案中安裝 Google Gen AI SDK。.
5. 在加入參考圖片或面向使用者的功能之前，請先執行一次低解析度的測試。.

API 金鑰頁面同樣對外公開，但能否建立或檢視金鑰，則取決於您的 Google 帳戶及專案權限。關鍵在於：切勿將該金鑰暴露在前端 JavaScript 中。瀏覽器或行動應用程式應呼叫您的後端，而您的後端則應呼叫 Gemini。.

登入後，AI Studio 的直接網址確實會跳轉至 Playground，並顯示 奈米香蕉專業版 獲選為 gemini-3-pro-image. 在這篇報導中，AI Studio 也指出了一個實際的使用限制：Nano Banana Pro 必須先訂閱 Google AI 方案或取得 API 金鑰，Playground 才能執行該程式。.

的 取得程式碼 在這個階段，這個按鈕仍值得確認。它可確認您目前處於開發者工作流程中，但如果該模型對該帳戶處於鎖定狀態，程式碼面板可能會開啟，但其中可能沒有完整的可執行程式碼片段。這是設定相關的提示，並非提示功能本身的錯誤。.

export GEMINI_API_KEY="您的 API 金鑰"

產生第一張圖片

第一個請求應刻意設計得簡單些。您需要檢查身份驗證、模型存取權限、回應格式以及檔案處理。花俏的提示功能可以等到系統運作順暢後再進行。.

from google import genai
from google.genai import types
import os

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

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=(
 "製作一個不鏽鋼旅行馬克杯的簡潔產品模型圖 "
 "置於白色桌面上。並加入可辨識的標籤：MORNING LAB。"
    ),
    config=types.GenerateContentConfig(
 response_modalities=["TEXT", "IMAGE"]
    ),
)

for part in response.candidates[0].content.parts:
    if part.text:
 print(part.text)
    elif part.inline_data:
 with open("nano-banana-pro-output.png", "wb") as f:
 f.write(part.inline_data.data)

這則提示要求生成一個文字清晰可讀的簡易產品模型。這能讓你快速掌握實際工作中三項關鍵要素：物體的寫實度、構圖，以及模型能否讓簡短文字保持清晰銳利。若想在不修改提示參數的情況下調整提示內容，請嘗試在 GlobalGPT 的 Nano Banana Pro 工作區 第一。.

附有參考資料的圖片編輯

「參考式編輯」正是 Nano Banana Pro 開始展現其價值之處。與其從頭開始要求生成新圖片，您只需提供一張圖片給模型，並明確告知哪些部分可以改變、哪些部分必須保持不變。.

如果您不是開發人員，請將此區塊視為工作流程範例，而非您需要實際執行的內容。檔案名稱 product-reference.png 這只是指「您現有的產品圖片」。如果您的主要工作是比較圖像模型，那麼更廣泛的 Gemini 3 Pro 替代方案測試 可以幫助您決定 Pro 版本是否值得額外花費時間進行設定。.

from google import genai
from google.genai import types
from PIL import Image
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
reference = Image.open("product-reference.png")

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=[
 reference,
 (
 "保留馬克杯的形狀、把手及標誌位置不變。 "
            "將背景改為明亮的廚房檯面，加入溫暖的晨光，"
 "並確保所有文字清晰易讀。"
 ),
    ],
    config=types.GenerateContentConfig(response_modalities=["TEXT", "IMAGE"]),
)

一個好的編輯提示聽起來幾乎就像是給設計師的回饋：保留這個、修改那個、不要移動標誌、確保文字清晰易讀。像「讓它看起來更高級」這類模糊的指示，往往會導致浪費製作次數，因為這讓模型必須自行揣測太多細節。.

定價與成本控制

在公布固定預算數字之前，請以 Google 的定價頁面作為權威參考來源。根據 2026 年 7 月 21 日的核實結果，Google 將 Nano Banana Pro 歸類於 Gemini 3 Pro Image 之下，並將文字／思考成本與圖像輸出成本分開計算。.

API 圖片輸出費用，核實日期：2026年7月21日

實際的成本模式很簡單：草稿階段節省成本，精修階段則精益求精。讓 Nano Banana 2 處理早期的變體，然後將最強力的提示語和參考資料傳送至 Nano Banana Pro 來生成最終圖像。此外，應根據使用者等級設定解析度上限，並在提示語未變更時避免重複生成；若您希望建立產品端的草稿產線，, Nano Banana 2 合 1 TP11T 這是較輕便的選項，建議先試試看。.

製作筆記

一旦使用者能夠透過您的產品生成圖像，您就需要建立防護機制。圖像 API 的成本可能會迅速攀升，且在說明失敗原因時，必須避免洩露服務供應商的原始詳細資訊。對於仍在決定哪些人員需要付費 AI 存取權限的團隊，亦可參考 ChatGPT 商業計畫指南.

• 將金鑰儲存於伺服器端： 請勿在瀏覽器或行動客戶端中傳輸 Gemini API 金鑰。.
• 記錄足夠的日誌以進行除錯： 模型 ID、提示詞雜湊值、輸出大小、延遲、使用者 ID 以及結果狀態。.
• 設定配額： 針對每位使用者、工作區及計費週期設定圖片數量上限。.
• 請謹慎重新嘗試： 應針對暫時性失敗進行重試，但請勿針對政策或配額錯誤進行循環重試。.
• 制定儲存規則： 請說明您會將生成的圖片和上傳的參考資料保存多久。.
• 撰寫有用的錯誤訊息： 告知使用者問題是出在存取權限、檔案格式、配額，還是提示政策上。.

GlobalGPT 的定位

GlobalGPT 最適合在 API 建置之前或同時進行。設計師可以將 Nano Banana Pro 與 奈米香蕉 2, 將 GPT Image、Flux 及其他影像模型整合於單一工作區中，然後將最佳的提示語模式交給開發人員。.

若需官方 API 金鑰、計費、日誌、企業級存取權限或 Vertex AI 路由功能，請繼續使用 Google 開發者平台。若想在提示字串開發過程中更快速地比較創意內容並減少開啟的分頁數量，, GlobalGPT 的圖像生成器工作區 可以讓早期作品顯得沒那麼笨拙。.

常見問題

Nano Banana Pro API 與 Gemini 3 Pro Image 是同一款產品嗎？

就開發工作而言，是的。Google 將 Nano Banana Pro 記載為 Gemini 3 Pro Image，其 API 型號 ID 為 gemini-3-pro-image.

我該選擇 Nano Banana Pro 還是 Nano Banana 2 呢？

若最終圖像需要更精準的控制、清晰可讀的文字、參考資料或品牌一致性，請使用 Nano Banana Pro。若需更快產出草稿並降低迭代成本，請使用 Nano Banana 2。.

我能否直接從前端 JavaScript 呼叫 Nano Banana Pro？

不。請將 API 金鑰保留在伺服器端，透過後端處理請求，並在將請求傳送至 Gemini API 之前，先套用使用者配額限制。.

GlobalGPT 是否取代了官方的 Google API？

No. GlobalGPT 雖適用於提示詞測試與多模型創意比較，但官方 API 金鑰、計費、日誌及企業級管控功能，應透過 Google 開發者平台進行管理。.

我該如何估算 Nano Banana Pro API 的費用？

請參考 Google 目前的 Gemini API 定價頁面，並根據模型、輸出解析度及影像體積進行估算。一種常見的成本控制模式是：先使用較低成本的模型進行草稿製作，然後針對選定的最終資產使用 Nano Banana Pro。.