nano-banana-2

Nano Banana 2 — RunComfy Pro Pack

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 個主軸。

反模式：

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

適用場景

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

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

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

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

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

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

垂直平台原生內容：

一張 9:16 垂直主視覺，用於健康品牌：單一陶瓷茶杯置於亞麻桌巾上，柔和晨間側光，上方大字手寫襯線字體「Slow Down」，輕柔蒸汽上升，中性色調，簡潔

限制

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

退出碼

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

完整參考：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 URL 下載至 --output-dir。Ctrl-C 會在結束前取消遠端請求。

安全性與隱私

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