模式: Text to Image
Comic Strip
建議的測試設定: 1:1
範例與提示詞
看看 Nano Banana 2 API 能創作什麼
真實的 Nano Banana 2 輸出及其背後的提示詞。複製提示詞並在 Playground 中測試。
模式: Image Editing
Magazine Cover
建議的測試設定: 1:1
模式: Text to Image
Illustrated Guide
建議的測試設定: 1:1
模式: Image Editing
High-Res Upscale
建議的測試設定: 1:1
模型規格
建構前先了解設定。
Topview API Platform 文件所列 Nano Banana 2 設定的快速參考。每種模式有各自的輸入要求。
| 參數 | 取值 |
|---|---|
| 供應商 / 模型 | Google / Nano Banana 2 |
| API 路由 | google/nano-banana-2 |
| 生成模式 | Text to Image · Image Editing |
| 解析度 | 1K · 2K · 4K (default 1K) |
| 長寬比 | 1:1 · 16:9 · 9:16 |
| Image Editing 輸入 | 1–2 images |
| 提示詞長度 | Up to 4,000 characters |
| 任務模式 | Async submission + polling + output retrieval |
| 價格 | Per generated image; settlement follows actual usage |
開發者快速開始
從 API 金鑰到第一張圖片。
使用 Platform API 金鑰提交非同步預測，然後輪詢回傳的任務 ID 以取得輸出。
# Set TOPVIEW_API_PLATFORM_KEY once. Preserve REQUEST_KEY and input for uncertain retries.
# For a NEW task only, unset REQUEST_KEY first. Save data.id to resume GET only.
: "${TOPVIEW_API_PLATFORM_KEY:?Set TOPVIEW_API_PLATFORM_KEY first}"
export REQUEST_KEY="${REQUEST_KEY:-$(uuidgen)}"
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/models/google/nano-banana-2/text-to-image/predictions' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY" \
-H "Idempotency-Key: $REQUEST_KEY" \
-H 'Content-Type: application/json' \
--data '{
"prompt": "A blue ceramic cup on a wooden table",
"aspect_ratio": "1:1",
"resolution": "1k"
}'
# Poll data.id until completed or failed.
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/predictions/REQUEST_ID' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY"範例與 Platform 文件中的 Nano Banana 2 text-to-image 請求一致。請僅在伺服器端保存 TOPVIEW_API_PLATFORM_KEY。
步驟 1
取得 API 金鑰
登入 Topview API Platform，建立具備所需模型權限的 API 金鑰。請妥善保管金鑰，並用它驗證 API 請求。
步驟 2
生成或編輯圖片
提交文字提示詞，或上傳用於編輯的參考圖。設定支援的圖像設定，傳送 API 請求，並儲存回傳的任務 ID。
步驟 3
取得圖片
檢查任務狀態直至生成完成。取得圖片 URL，查看最終用量費用，並儲存生成的圖片。
面向製作工作流程
將一兩張來源圖變成可直接使用的概念圖
Nano Banana 2 為圖像生成產品提供精選尺寸與常見長寬比，適合實用行銷與編輯任務。
商品場景變體
在使用一兩張編輯參考的同時，將商品照片變成其他背景或生活方式呈現。
社交活動格式
使用 1:1、16:9 或 9:16，為貼文、縮圖和廣告版位建立方形、寬螢幕與直式圖像概念。
雙參考構圖
用兩張來源圖引導組合視覺概念，例如將產品放入選定環境。
高解析度行銷草稿
為活動概念、視覺樣稿與素材審閱流程選擇 1K、2K 或 4K 輸出。
為什麼選擇 TOPVIEW API
面向實用整合的直觀圖像設定
在測試與建構時，Topview 持續展示 Nano Banana 2 支援的模式、輸出尺寸與參考圖上限。
比較三個解析度檔位
在決定各任務合適尺寸前，查看 1K、2K 與 4K 的目前按圖價格。
測試單圖與雙圖編輯
使用 Playground 與文件，確認編輯路由如何處理模型支援的參考圖輸入。
聚焦常見輸出比例
實作三種支援格式——方形、橫向與直向——而不暴露不支援的長寬比選項。
與 Nano Banana 2.1 比較
使用同一 Platform 帳戶，評估應用是否需要 2.1 變體更廣的長寬比與參考圖支援。
Nano Banana 2 API 常見問題
你可以開啟 Nano Banana 2 Playground 查看設定。API 用量從 Platform USD 餘額扣費，促銷積分會隨時間變化。請在 Topview API Platform 查看工作區目前資格與餘額。
Topview API Platform 列出 Text to Image 與 Image Editing。Image Editing 接受一兩張輸入圖與提示詞。
Nano Banana 2 以 1:1、16:9 或 9:16 輸出 1K、2K 或 4K 圖像。價格取決於解析度。
在 Topview API Platform 上，Nano Banana 2.1 支援 14 種長寬比、最多 14 個編輯輸入與更長提示詞，且目前按圖費率更低。Nano Banana 2 支援三種長寬比與最多兩個編輯輸入。選擇前請比較兩張價格表。
建立 Platform API 金鑰，向 Nano Banana 2 端點提交帶 Idempotency-Key 的預測，儲存回傳的任務 ID 並輪詢至完成。結果 URL 可能過期，請及時下載圖片。金鑰請保存在伺服器端。
下一張圖片從這裡開始
使用 Nano Banana 2 API 建構
在 Playground 中試用第一條提示詞，比較目前價格，或依文件將 Nano Banana 2 整合到應用中。