flux-kontext

Flux Kontext Pro — Pro Pack on RunComfy

runcomfy.com · Model page · GitHub

Black Forest Labs 的 Flux 1 Kontext Pro — 單參考精確局部影像編輯 — 託管於 RunComfy Model API。強大的提示控制、一致的輸出、高保真度。

npx skills add agentspace-so/runcomfy-skills --skill flux-kontext -g

何時選擇此模型（相較於同系列其他模型）

您想要	使用
單張影像精確局部編輯（「她現在拿著X」）	Flux Kontext
高保真保留來源身份	Flux Kontext
批次編輯 1–20 張影像	Nano Banana Edit
編輯影像中的多語言/嵌入文字	GPT Image 2 edit
從頭生成，無來源影像	Flux 2 Klein

如果使用者明確提到「Flux Kontext」/「kontext」/「BFL Kontext」，無論如何都路由至此。

前置需求

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

端點 + 輸入架構

blackforestlabs/flux-1-kontext/pro/edit

欄位	類型	必填	預設值	備註
prompt	string	是	—	單一宣告式編輯指令。
image	string	是	—	單張來源影像 URL（可公開存取的 HTTPS）。
aspect_ratio	enum	否	(輸入)	從模型頁面支援的 W:H 選項中選擇。
seed	int	否	—	重複使用以比較變體。

此架構刻意簡潔 — Kontext 依賴提示 + 單一參考。對於多影像或網路基礎的編輯，請路由至 Nano Banana Edit。

如何呼叫

預設 — 局部編輯，保留其他所有內容：

runcomfy run blackforestlabs/flux-1-kontext/pro/edit \
  --input '{
    "prompt": "Keep the person'\''s face, pose, and clothing unchanged. Add an orange umbrella in her left hand and a slight smile.",
    "image": "https://.../portrait.jpg"
  }' \
  --output-dir <absolute/path>

使用種子以產生可重現的變體系列：

runcomfy run blackforestlabs/flux-1-kontext/pro/edit \
  --input '{
    "prompt": "Keep the bottle, label, and lighting unchanged. Replace the brand text on the label from \"ALPHA\" to \"AURA\".",
    "image": "https://.../bottle.jpg",
    "seed": 42
  }' \
  --output-dir <absolute/path>

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

單一宣告式指令。 Kontext 在類似文件範例的提示上表現出色："She is now holding an orange umbrella and smiling"。祈使語氣，單一變更。

先保留。 以 "Keep [identity / pose / framing / brand] unchanged." 開頭。然後再進行變更。模型會優先遵循開頭陳述的內容。

僅單一參考 — 選擇正確的。 此處無多影像分發。如果您有多個參考，請決定哪個是主要的並傳遞該參考。對於多影像流程，請路由至 Nano Banana Edit。

對小變更進行迭代。 如果 Kontext 偏離，請將複合編輯拆分為連續的單一指令傳遞（傳遞 1：變更背景，傳遞 2：變更服裝）。

長寬比 — 從支援的列舉中選擇。 列表外的值會導致 422 或裁切。

反模式：

• 複合提示（「變更 A 並新增 B 並移除 C」）→ 偏離。
• 嘗試分發到多個來源影像 → 錯誤模型（使用 Nano Banana Edit）。
• 被動語態的提示 → 較不可靠。
• 要求無來源影像的新構圖 → 錯誤模型（使用 Flux 2 Klein t2i）。

適用場景

使用案例	為何選擇 Flux Kontext
單次精確局部編輯	專為此設計；高保真度
透過目標變更保留來源身份	在明確指令下具有強大的保留能力
品牌資產文字或顏色替換	引號文字 + 保留前置效果良好
單張影像快速迭代	簡短提示 + 單一參考 = 快速結果循環

範例提示（經驗證可產生強烈結果）

頁面範例：

She is now holding an orange umbrella and smiling

保留主導的品牌編輯：

Keep the bottle silhouette, table, and lighting exactly as in the input.
Replace only the brand text on the label, from "ALPHA" to "AURA".
Same font weight, white on black, centered.

構圖微編輯：

Keep the person's face, pose, and clothing unchanged. Add a leather
shoulder bag, dark brown, hanging on the right shoulder.

限制

• 僅單張來源影像。 對於多影像流程，請使用 Nano Banana Edit（1–20）。
• 公開的 RunComfy 文件極簡 — 除了 prompt + image + aspect_ratio + seed 之外，可能還有其他架構欄位；請查看模型頁面以取得最新欄位列表。
• 複合提示會偏離 — 拆分為連續傳遞。
• 對於多語言/嵌入文字編輯，GPT Image 2 edit 通常勝出。

退出碼

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

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

運作方式

此技能使用符合架構的 JSON 主體呼叫 runcomfy run blackforestlabs/flux-1-kontext/pro/edit。CLI 將 POST 至 https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-1-kontext/pro/edit，輪詢請求，取得結果，並將任何 .runcomfy.net/.runcomfy.com URL 下載至 --output-dir。Ctrl-C 會在退出前取消遠端請求。

安全性與隱私

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