nano-banana-2

Nano Banana 2 — RunComfy 專業包

runcomfy.com · 模型頁面 · GitHub

Google Nano Banana 2 — Gemini 系列中的快階文字轉圖片模型 — 託管於 RunComfy Model API。專為創意發想、社群縮圖批次處理及快速草稿最佳化，並具備強大的圖片內文字渲染能力。

npx skills add agentspace-so/runcomfy-skills --skill nano-banana-2 -g

何時選擇此模型（與同系列比較）

Nano Banana 2 是 Google 圖片生成系列的快階版本。當迭代速度和可預測構圖比最大細節更重要時，請選擇它。

您想要	使用
快速草稿、社群縮圖、批次變體	Nano Banana 2
圖片內文字且渲染可預測	Nano Banana 2
網路背景圖片（時事/真實實體）	Nano Banana 2 + enable_web_search
圖片編輯（保留主體，更換背景）	Nano Banana Edit（同系列技能）
強烈風格化、繪畫感	Flux 2
最大提示遵循度 + 多語言文字	GPT Image 2
2K–4K 主視覺、最大真實感	Seedream 5
超寫實人像	Nano Banana Pro

如果使用者明確提到「Nano Banana」/「nano-banana-2」/「Gemini image」，請直接導向此處。如果只說「Nano Banana」而未指定 2 或 Pro，人像預設用 Pro，其他情況用 2。

前置需求

1. RunComfy CLI — npm i -g @runcomfy/cli
2. RunComfy 帳號 — runcomfy login 會開啟瀏覽器裝置碼流程。
3. CI / 容器環境 — 設定 RUNCOMFY_TOKEN=<token> 取代 runcomfy login。

端點 + 輸入結構

google/nano-banana-2/text-to-image

欄位	型別	必填	預設值	說明
prompt	string	是	—	主體優先的描述。
num_images	int	否	1	1–4。創意發想輪次使用 4。
seed	int	否	0	重複使用以確保可重現性。
aspect_ratio	enum	否	auto	auto, 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16。
resolution	enum	否	1K	0.5K（草稿）, 1K（預設）, 2K（最終版）, 4K（最大）。
output_format	enum	否	png	png, jpeg, webp。
safety_tolerance	int	否	4	1（嚴格）– 6（寬鬆）。
limit_generations	bool	否	true	限制每個提示輪次僅生成一次。
enable_web_search	bool	否	false	加入網路背景資訊（額外費用 + 延遲）。

如需圖片編輯（保留主體並套用變更），請參閱同系列技能 nano-banana-edit。

如何呼叫

預設草稿（1K, 正方形, png）：

runcomfy run google/nano-banana-2/text-to-image \
  --input '{"prompt": "<使用者提示>"}' \
  --output-dir <絕對路徑>

垂直四連發批次用於創意發想：

runcomfy run google/nano-banana-2/text-to-image \
  --input '{
    "prompt": "<使用者提示>",
    "num_images": 4,
    "aspect_ratio": "9:16",
    "resolution": "0.5K"
  }' \
  --output-dir <絕對路徑>

最終版 2K 並鎖定種子：

runcomfy run google/nano-banana-2/text-to-image \
  --input '{
    "prompt": "<使用者提示>",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "seed": 42
  }' \
  --output-dir <絕對路徑>

網路背景（時事/真實實體）：

runcomfy run google/nano-banana-2/text-to-image \
  --input '{
    "prompt": "<提及本週真實事件的提示>",
    "enable_web_search": true
  }' \
  --output-dir <絕對路徑>

提示技巧 — 實際有效的方法

主體優先的陳述式語法。 「一個電影級特寫人像，一位美國女性站在雨夜東京的霓虹燈下，淺景深，潮濕反光的街道，超精細，真實肌膚質感」— 先寫主體，再寫動作、環境、風格、鏡頭。主體前置，指示後綴。

圖片內文字的精確引用。 「標籤上寫著 'AURA'，使用乾淨粗體無襯線字體，置中，白字黑底」— 引用實際字元。指定位置和字體風格。不要只說「上面有品牌名稱」然後期望結果。

使用固定種子進行細化。 在針對同一提示進行小幅變體迭代時鎖定 seed — 保持構圖穩定。

謹慎使用網路背景。 僅在提示提及時事/真實實體時才啟用 enable_web_search。會增加延遲和費用，預設關閉。

避免風格衝突。 「極簡 + 華麗 + 復古 + 賽博龐克」會互相抵消。選擇 1–2 個主軸。

反模式：

• 試圖用文字描述穩定的主體身份 — 請改用編輯端點搭配圖片參考。
• 要求超出四個等級的解析度 → 422。
• 使用 11 個支援值以外的長寬比 → 422。
• 未引用的圖片內文字 → 渲染結果不可預測。

適用場景

使用案例	為何選擇 Nano Banana 2
行銷草稿縮圖（批次 4 張）	以 0.5K 快速迭代，再將優勝者提升至 2K
社群平台原生內容	支援多種長寬比，包括 9:16、4:5、21:9
海報/卡片內的圖片文字	引用字元時文字渲染可預測
網路背景的時事圖片	enable_web_search 整合最新資訊
可重現的變體測試	穩定的種子 + 一致的構圖

範例提示（經驗證可產出優質結果）

電影級人像（頁面範例）：

一個電影級特寫人像，一位美國女性站在雨夜東京的霓虹燈下，
淺景深，潮濕反光的街道，超精細，真實肌膚質感

含引用文字的品牌素材卡片：

一張極簡 16:9 產品卡：一個霧面黑色陶瓷馬克杯置中於柔和的
暖灰紙張背景上，左上角邊緣打光，標題「Brewed Quietly」
以乾淨粗體無襯線字體置於右上角，下方留白平衡，
適合電商，乾淨的棚拍燈光

垂直平台原生內容：

一張 9:16 垂直主視覺，用於健康品牌：一個陶瓷茶杯放在亞麻
桌巾上，柔和的早晨側光，上方大字手寫襯線字體寫著「Slow Down」，
輕柔的蒸氣上升，中性色調，簡潔不雜亂

限制

• 僅限靜態圖片。 此端點不支援影片。
• 每次請求最多 4 張輸出。
• 網路搜尋會增加延遲和費用 — 僅在需要時啟用。
• 2K / 4K 費用較高 — 除非使用者要求更高，否則預設使用 1K。
• 如需圖片編輯，請使用 /edit 端點 — 非此端點。

結束代碼

代碼	意義
0	成功
64	CLI 參數錯誤
65	輸入 JSON 錯誤 / 結構不符
69	上游 5xx 錯誤
75	可重試：超時 / 429
77	未登入或令牌被拒絕

完整參考：docs.runcomfy.com/cli/troubleshooting。

運作方式

技能會以符合結構的 JSON 主體呼叫 runcomfy run google/nano-banana-2/text-to-image。CLI 會 POST 到 https://model-api.runcomfy.net/v1/models/google/nano-banana-2/text-to-image，輪詢請求狀態，取得結果，並將任何 .runcomfy.net/.runcomfy.com 網址下載到 --output-dir。Ctrl-C 會在結束前取消遠端請求。

安全性與隱私

• 令牌儲存：runcomfy login 將 API 令牌寫入 ~/.config/runcomfy/token.json，權限設為 0600（僅擁有者可讀寫）。在 CI / 容器環境中，可設定 RUNCOMFY_TOKEN 環境變數以繞過檔案。
• 輸入邊界：使用者提示透過 --input 以 JSON 字串傳遞給 CLI。CLI 不會對提示進行 shell 展開；它直接透過 HTTPS 將 JSON 主體傳送給 Model API。提示內容不會造成 shell 注入風險。
• 第三方內容：您傳遞的圖片 / 遮罩 / 影片網址由 RunComfy 模型伺服器擷取，而非您機器上的 CLI。請將外部網址視為不可信任；基於圖片的提示注入是任何圖片編輯 / 影片編輯模型的已知風險。
• 對外端點：僅 model-api.runcomfy.net（請求提交）和 *.runcomfy.net / *.runcomfy.com（生成輸出的下載白名單）。無遙測、無回呼。
• 生成檔案大小上限：CLI 會中止任何單一下載超過 2 GiB 的檔案，以防止惡意或失控的模型輸出導致磁碟填滿。