商品與生活方式概念
根據提示詞建立商品相關場景，或修改單張商品照片以獲得不同視覺效果。
模型規格
建構前先了解設定。
Topview API Platform 文件所列 Nano Banana 設定的快速參考。每種模式有各自的輸入要求。
| 參數 | 取值 |
|---|---|
| 供應商 / 模型 | Google / Nano Banana |
| API 路由 | google/nano-banana |
| 生成模式 | Text to Image · Image Editing |
| 解析度 | Standard output (no resolution parameter) |
| 長寬比 | 1:1 · 16:9 · 9:16 · 4:3 · 3:4 |
| Image Editing 輸入 | 1 image |
| 提示詞長度 | 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/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"
}'
# 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 text-to-image 請求一致。請僅在伺服器端保存 TOPVIEW_API_PLATFORM_KEY。
步驟 1
取得 API 金鑰
登入 Topview API Platform，建立具備所需模型權限的 API 金鑰。請妥善保管金鑰，並用它驗證 API 請求。
步驟 2
生成或編輯圖片
提交文字提示詞，或上傳用於編輯的參考圖。設定支援的圖像設定，傳送 API 請求，並儲存回傳的任務 ID。
步驟 3
取得圖片
檢查任務狀態直至生成完成。取得圖片 URL，查看最終用量費用，並儲存生成的圖片。
面向製作工作流程
為日常應用加入簡單的圖像建立與編輯
原版 Nano Banana API 以一種標準輸出尺寸和精簡的參考編輯控件，支援常見圖像生成任務。
五種比例的社交圖形
在含 4:3 與 3:4 的五種支援長寬比中，生成方形、橫向或直向概念圖。
單圖創意編輯
讓使用者用一張編輯輸入重塑照片風格、改變周圍環境，或探索新的構圖方向。
入門級圖像功能
為創作者工具、內部流程或小型行銷應用加入基礎 text-to-image 與單圖編輯。
為什麼選擇 TOPVIEW API
原版 Nano Banana API 的簡潔入口
對於想使用原版模型而非更新 Nano Banana 變體的團隊，Topview 提供已文件化的模式與格式選項。
標準尺寸計價模型
查看目前按圖費率，無需新增不支援的 2K 或 4K 解析度選擇器。
五種支援的長寬比
在對應產品輸出設定前，先測試 1:1、16:9、9:16、4:3 與 3:4。
測試單圖編輯
使用專用編輯路由與文件化輸入要求，用單張來源圖探索基於提示詞的編輯。
比較 Nano Banana 系列
在同一 Topview 工作區中，隨輸出與編輯需求變化，評估原版模型與 Lite、2、2.1。
Nano Banana API 常見問題
你可以開啟 Nano Banana Playground 查看設定。API 用量從 Platform USD 餘額扣費，促銷積分會隨時間變化。請在 Topview API Platform 查看工作區目前資格與餘額。
Topview API Platform 列出 Text to Image 與 Image Editing。Image Editing 接受一張輸入圖與提示詞。
Nano Banana 支援 1:1、16:9、9:16、4:3 與 3:4。沒有解析度參數；每次請求回傳一種標準輸出尺寸。
Nano Banana 與 Nano Banana 2 Lite 均提供無解析度選擇器的簡單按圖計費。請依支援的長寬比、編輯輸入與目前費率選擇。若需要可選 2K 或 4K 輸出，請比較 Nano Banana 2 與 Nano Banana 2.1。
建立 Platform API 金鑰，向 Nano Banana 端點提交帶 Idempotency-Key 的預測，儲存回傳的任務 ID 並輪詢至完成。結果 URL 可能過期，請及時下載圖片。金鑰請保存在伺服器端。
探索相關 API
更多 AI 圖像模型，同一目的地。
下一張圖片從這裡開始
使用 Nano Banana API 建構
在 Playground 中試用第一條提示詞，比較目前價格，或依文件將 Nano Banana 整合到應用中。