Nano Banana 2 實戰:AI Studio 免費層生成第一張 API 圖片
MidassAI Team · 2026年8月8日 · 7 min read

您無需付費的雲端專案即可觸及 Nano Banana 2。AI Studio 的免費層足以進行 UI 測試和生成第一張 API 圖片—在投入生產前請先了解限制。
UI 路徑(兩分鐘)
- 開啟 Google AI Studio 並登入。
- 模型選擇器 → Gemini 3.1 Flash Image(Nano Banana 2 系列)。
- 提示詞:
Product photo of a stainless water bottle on white, soft shadow, 4:5。 - 下載或使用後續編輯進行迭代。
注意速率限制:免費層會限制突發流量;批次作業應使用帶有計費的 Vertex。
API 路徑(開發者)
- AI Studio → 取得 API 金鑰(切勿提交至 Git)。
- 使用當前文件支援圖片的 Gemini 模型 ID(例如
gemini-3.1-flash-image-preview—發布前請在 Studio 中驗證)。 - 使用您的文字提示詞發送多模態
generateContent請求。
偽代碼流程:
# 將金鑰存於環境變數 — 切勿提交至 repo
export GEMINI_API_KEY="your-key"您的應用程式應從環境變數讀取金鑰,在提示詞或設定中設定長寬比,並將二進制圖片位元組儲存至磁碟。
從 UI 轉移至 API 的提示詞技巧
- 為確保可靠性,每個請求僅處理一個場景。
- 引用文字字面量。
- 若 SDK 缺乏調整旋鈕,請用自然語言要求長寬比。
安全性
金鑰僅存放在 .env.local 中;若洩漏請輪換。MidassAI 網站建構 絕不可 嵌入金鑰—本教學僅適用於您的本機工具。
下一步
一旦首次呼叫成功,將提示詞包裝在您的 CMS 或 MidassAI Nano 工作流程中,讓行銷人員無需接觸 curl。
先決條件與設定
您需要啟用 AI Studio 存取權限的 Google 帳戶才能繼續。標準消費者帳戶可用於測試,但組織政策可能會封鎖外部 API 金鑰生成。請確保您已安裝如 VS Code 等程式碼編輯器,以便在本機安全地管理環境變數。能夠執行 curl 命令的終端機有助於在整合至大型應用程式前驗證 API 回應。
假設測試期間模型識別碼仍為 gemini-3.1-flash-image-preview。Google 經常更新端點名稱,因此請每週檢查模型選擇器是否有變更。若您計畫自動化生成,請安裝最新的 Python SDK 或準備好 HTTP 客戶端進行直接呼叫。切勿依賴已棄用的 v1 端點進行圖片生成任務。
進階提示詞工作流程
- 在文字字串中明確定義照明條件。不要使用「柔和陰影」等模糊術語,請指定
key light at 45 degrees, fill ratio 1:2以減少生成之間的變異。 - 透過自然語言設定解析度限制。若此模型版本的 API 設定缺乏明確的維度欄位,請在提示詞中寫入
output resolution 1024x1024。 - 包含負面約束以清理偽影。添加
no text overlays, no watermarks, clean background以防止需要後製的常見渲染錯誤。 - 使用種子連結請求以獲得變體。發送五個具有不同種子值的相同提示詞,以便無需人工干預即可透過程式選擇最佳構圖。
- 嚴格驗證輸出格式。在嘗試解碼前檢查回應 JSON 中是否包含 base64 圖片字串的
inlineData,以避免腳本因空回應而崩潰。
常見錯誤
- 在腳本中硬編碼憑證: 開發者常為了速度將金鑰直接貼入原始檔案。請透過使用
.env檔案並藉由python-dotenv等函式庫載入來修正,以永久將機密排除在版本控制系統之外。 - 忽略速率限制標頭: 免費層在測試期間達到閾值後會靜默拒絕請求。請透過在收到伺服器 429 狀態碼時於重試機制中實作指數退避邏輯來修正。
- 單個提示詞過載: 一次性要求包含多個主題的複雜場景經常失敗。請透過將複雜影像分解為單獨的生成呼叫,隨後使用標準圖片編輯工具進行合成來修正。
在 MidassAI 中嘗試
若想獲得無需處理原始 API 金鑰的托管體驗,請直接使用 MidassAI 介面。它將 Nano Banana 2 的功能包裝成視覺化工作流程建構器,讓您在無需撰寫樣板程式碼或管理安全憑證的情況下測試提示詞並儲存迭代。直接前往 https://www.midassai.com/studio/nano/ 開始建構您的圖片生成管道,以簡化生產部署並整合現有的行銷工具。