模式: Text to Image
產品实拍
将同一產品放入多種場景，用於廣告、列表与社群貼文。
Nano Banana 2.1 API。4K 图片，按張计价。
透過 Topview API 將 Nano Banana 2.1 圖像產生与編輯接入產品。以 14 種寬高比建立 1K、2K 或 4K 图片，最多用 14 張輸入图編輯；提供透明按張定價、即用 Playground 与開發者文件。
低於官方費率1K · 2K · 4K14 種寬高比最多 14 張图編輯
免费試用 Nano Banana 2.1 API
設定
Text to Image · 1k
此處設定為預覽。Generate 會複製提示詞並開啟對應的 Platform Playground，請在那裡確認最終設定。
範例與提示詞
看看 Nano Banana 2.1 API 能做什么
真實 Nano Banana 2.1 輸出与對應提示詞。複製提示詞並在 Playground 中測試。
模式: Text to Image
海报与資訊圖
產生標題与標籤更清晰的海报与資訊圖，服務活動版式。
模式: Text to Image
角色系列
在漫畫、活動或分鏡序列中保持同一角色。
模式: Text to Image
视频縮圖
以自有影片為参考，製作與內容相符的縮圖与封面。
模型規格
接入前先了解相關設定。
Topview API Platform 文件中 Nano Banana 2.1 設定的快速參考。各模式有各自的輸入要求。
| 參數 | 取值 |
|---|---|
| 提供方 / 模型 | Google / Nano Banana 2.1 |
| API 路由 | google/nano-banana-2.1 |
| 產生模式 | Text to Image · Image Editing |
| 解析度 | 1K · 2K · 4K（預設 1K） |
| 寬高比 | 1:1 · 3:2 · 2:3 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9 · 1:4 · 4:1 · 1:8 · 8:1 |
| Image Editing 輸入 | 1–14 images |
| 提示詞長度 | 最多 10,000 字符 |
| 任務模式 | 非同步提交 + 輪詢 + 取得輸出 |
| 價格 | 按產生圖片計費；依實際用量結算 |
開發者快速開始
從 API key 到第一張圖片。
用 Platform API key 提交非同步 prediction，再輪詢回傳的任務 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.1/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",
"resolution": "1k",
"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 2.1 文生图請求一致。请僅在伺服器端儲存 TOPVIEW_API_PLATFORM_KEY。
步驟 1
取得 API key
登入 Topview API Platform，建立具備所需模型權限的 API key。請妥善保管金鑰，並用它驗證 API 請求。
步驟 2
產生或編輯圖片
提交文字提示詞，或上傳用於編輯的參考圖。設定支援的圖片選項，傳送 API 請求，並儲存回傳的任務 ID。
步驟 3
取得圖片
檢查任務狀態直至產生完成。取得圖片 URL，核對最終用量費用，並儲存產生的圖片。
面向製作工作流程
建置靈活、偏重參考圖的圖像工作流程
Nano Banana 2.1 支援高解析度素材、非常規寬高比与多圖編輯，適合需要不止一張來源照片的創意系统。
多圖產品合成
在編輯請求中組合多張產品、場景与造型圖，打造更豐富的電商視覺与活動構圖。
跨版式活動素材
利用 14 種寬高比（含橫幅友善格式）建立方形、直式、橫式与超寬畫面。
4K 品牌與編輯視覺
为高細節創意概念、行銷版式与視覺内容製作產生或編輯 1K、2K 或 4K 图片。
基於参考的設計流程
建置可接受最多 14 張來源圖的圖像編輯工具，用於引導構圖、視覺更新与創意探索。
為什麼選擇 TOPVIEW API
在一個 API 中獲得更多參考輸入与輸出尺寸
在產品上線前，用 Topview 探索 Nano Banana 2.1 更廣的圖像輸入与格式選項。
試用最多 14 張編輯輸入
在 Playground 測試真實來源圖組合，集成时遵循 Image Editing schema。
按輸出解析度定價
分別比较 1K、2K、4K 的按張費率，而不是假定一種價格適用所有設定。
預覽非常規寬高比
驗證全部 14 種比例，涵蓋寬橫幅、社群版位与特殊創意格式。
在同一工作區使用圖像模型
無需单独開設其他供應商帳戶，即可對比 Nano Banana 2.1、Nano Banana 2 等圖像 API。
Nano Banana 2.1 API 常見問題
你可以打开 Nano Banana 2.1 Playground 查看設定。API 用量从 Platform 美元餘額扣款，促銷點數会随时间变化。请在 Topview API Platform 查看目前工作區資格与餘額。
Topview API Platform 列出 Text to Image 与 Image Editing。Image Editing 接受 1–14 張輸入图及提示詞。
Nano Banana 2.1 可輸出 1K、2K 或 4K，并支援 14 種寬高比，从 1:1、16:9 到 1:8、8:1 等極端格式。價格取決於解析度。
每張產生图按對應解析度費率计费，目前 Text to Image 与 Image Editing 費率相同。提交会預留資金，请在已完成任务上讀取 charged_usd 作為最終費用。
建立 Platform API key，使用 Idempotency-Key 向 Nano Banana 2.1 端點提交 prediction，儲存返回的任務 ID 并輪詢至完成。請盡快下載图片，因為結果 URL 可能過期。金鑰請保留在伺服器端。
下一張圖片從這裡開始
用 Nano Banana 2.1 API 建置
在 Playground 試用第一條提示詞，對比目前價格，或依文件將 Nano Banana 2.1 整合到應用。