flux-2-klein

Flux 2 Klein — RunComfy 專業包

runcomfy.com · 9B 模型 · 4B 模型 · GitHub

Black Forest Labs 的 Flux 2 Klein（Flux 2 的蒸餾低延遲變體）託管於 RunComfy Model API — 無需 API 金鑰，非同步 REST。

npx skills add agentspace-so/runcomfy-skills --skill flux-2-klein -g

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

Flux 2 Klein 的獨特優勢在於以延遲為優先的創意迭代：亞秒級回饋可實現即時美術指導與快速產品視覺化，這是批次式模型無法達成的。當迭代速度比極限解析度更重要時，請選擇它。

您想要	使用
即時 / 現場美術指導	Flux 2 Klein 4B
快速迭代且最終細節豐富	Flux 2 Klein 9B
多參考品牌風格，外觀一致	Flux 2 Klein
2K–4K 主視覺圖片，最高解析度	Seedream 5
最大提示遵循度 + 極致細節	Flux 2 Pro
內嵌文字、標誌、多語言標示	GPT Image 2
超寫實人像	Nano Banana Pro

如果使用者明確提到「Flux 2 Klein」/「BFL Klein」/「flux klein」，請直接路由至此。如果他們只說「Flux 2」，請在預設前詢問他們想要 Klein（快速）還是 Pro（最高品質）。

先決條件

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

端點 + 輸入結構

兩種變體，相同端點形狀，相同提示語法。

blackforestlabs/flux-2-klein/9b/text-to-image

以保真度為優先的變體。用於精修 / 最終輸出。

欄位	類型	必填	預設值	備註
prompt	字串	是	—	最多約 512 個 token。更長會降低品質。
steps	整數	否	25	4–50。步數蒸餾架構 — 4–8 步足夠概念探索；約 25 步精修；超過 25 步效益不大。
width	整數	否	1024	典型範圍 512–1536。長寬比上限 16:9，總解析度最大約 2K。
height	整數	否	1024	與 width 的長寬意圖一致。

blackforestlabs/flux-2-klein/4b/text-to-image

以延遲為優先的變體。亞秒級 4 步推論。用於即時迭代 / 概念探索。

欄位集與 9B 相同。預設 steps 實際上為 4 — 此變體專為該步數設計。

參考圖片（兩種變體）

同一端點最多支援 4 張同時參考圖片，用於風格轉移 / 引導構圖。JSON 主體中的確切欄位名稱記錄在模型的 API 標籤頁 — 請直接透過 CLI 傳遞。使用參考圖片可實現類似編輯的工作流程，無需獨立的 /edit 端點。

如何呼叫

快速概念探索（4B，亞秒級）：

runcomfy run blackforestlabs/flux-2-klein/4b/text-to-image \
  --input '{"prompt": "<使用者提示>"}' \
  --output-dir <絕對路徑>

精修 / 最終（9B，約 25 步）：

runcomfy run blackforestlabs/flux-2-klein/9b/text-to-image \
  --input '{
    "prompt": "<使用者提示>",
    "steps": 25,
    "width": 1024,
    "height": 1024
  }' \
  --output-dir <絕對路徑>

寬版海報：

runcomfy run blackforestlabs/flux-2-klein/9b/text-to-image \
  --input '{"prompt": "<使用者提示>", "width": 1536, "height": 864}' \
  --output-dir <絕對路徑>

CLI 會提交請求，每 2 秒輪詢直到終止狀態，然後將結果中所有 *.runcomfy.net / *.runcomfy.com 網址下載到 --output-dir。標準輸出為結果 JSON。標準錯誤為進度。

適用於管線的用法：

runcomfy --output json run blackforestlabs/flux-2-klein/4b/text-to-image \
  --input '{"prompt":"..."}' --no-wait | jq -r .request_id

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

以下是經實證可提升輸出品質的模型專屬模式。

主體優先的宣告式語法。 Flux 2 Klein 訓練所用的結構為 「主體 + 動作 + 場景 + 風格 + 燈光 + 相機 + 品質」。將主體放在前面，後面接指令。範例："A vibrant hummingbird mid-flight sipping nectar from a bright pink hibiscus, iridescent feathers in morning sun, soft bokeh tropical garden, macro photography, razor-sharp detail, cinematic lighting"。

具體性勝過華麗詞藻。 「4k 產品照，柔光箱燈光，反射桌面，35mm，f/2.8」能可靠引導模型。「一張很漂亮的產品圖片」則不行。

依階段調整步數。

• 概念探索：使用 4B 變體，4–8 步 — 亞秒級回饋，適合即時探索。
• 精煉：仍使用 4B，8–15 步，鎖定主體與構圖。
• 精修：使用 9B 變體，約 25 步 — 紋理、微細節、精細字體。

多參考圖片對齊。 傳遞參考圖片時，保持其美學風格一致。在同一呼叫中混合水彩 + 寫實 + 3D 渲染會混淆編輯器。在所有參考圖片中選擇一個一致的視覺風格。

條件式編輯：先說明保留什麼，再說明改變什麼。「與參考圖片相同的構圖和燈光，但將背景從海灘改為山景工作室。」 此模式能穩定構圖。

文字渲染（Klein 使用 8B Qwen3 嵌入器，表現不錯但不及 GPT Image 2）：加入 "crisp typography, high-contrast label"，如果文字模糊則將步數提高到約 25。對於大量圖內文字或多語言渲染，請改用 GPT Image 2。

反模式：

• 不要使用衝突的形容詞。「極簡 + 華麗」會互相抵消。
• 不要超過約 512 個 token。模型會降級，不會優雅截斷。
• 不要要求 4K — 模型的解析度上限約為 2K。
• 不要要求超寬比例（>16:9）— 模型會裁切。

擅長領域

使用案例	為何選擇 Flux 2 Klein
即時美術指導	亞秒級回饋（4B）實現即時迭代
互動式產品視覺化	快速 UI 預覽與產品合成，無需批次等待
多參考品牌風格	跨參考圖片的強烈風格一致性，打造統一素材包
快速概念探索到精修流程	4B 用於探索，9B 用於最終處理 — 全程使用相同提示語法
消費級 GPU 友善推論	4B 變體可在一般硬體上運行；與自託管比較相關，但 RunComfy 託管也沒問題

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

來自模型頁面（BFL 範例）：

A vibrant hummingbird mid-flight sipping nectar from a bright pink hibiscus
flower, iridescent emerald and sapphire feathers catching the morning sun,
soft bokeh tropical garden background, macro photography, razor-sharp
detail, cinematic lighting

產品照模式：

A matte ceramic mug on a reclaimed-wood table, soft northern window light
from the left, shallow depth of field, 50mm prime, f/2.0, neutral
background, e-commerce ready, 4K product photography

品牌一致組合（多參考）：

Same composition and lighting as the reference image, but the bottle
label is now blue with white sans-serif typography reading "AURA";
keep the bottle silhouette, table, and shadow exactly as in the reference

限制

• 解析度上限約 2K — 需要更高原生解析度時，請改用 Seedream 5。
• 長寬比上限 16:9 — 極寬/極高比例會被裁切。
• 提示上限約 512 個 token — 更長會降低品質；不會優雅截斷。
• 參考圖片上限 4 張 — 超過 4 張會增加延遲並稀釋引導效果。
• 文字渲染 — 8B Qwen3 嵌入器有幫助，但內嵌文字精確度仍以 GPT Image 2 為佳。

退出碼

runcomfy CLI 使用 sysexits 風格的代碼：

代碼	意義
0	成功
64	CLI 參數錯誤
65	輸入 JSON 錯誤 / 結構不符（例如 width: 4096 會回傳 422）
69	上游 5xx 錯誤
75	可重試：超時 / 429
77	未登入或 token 被拒絕

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

運作方式

1. 技能以符合結構的 JSON 主體呼叫 runcomfy run blackforestlabs/flux-2-klein/<variant>/text-to-image。
2. CLI 使用使用者的 bearer token 向 https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-2-klein/<variant>/text-to-image 發送 POST 請求。
3. Model API 回傳 request_id；CLI 每 2 秒輪詢 GET .../requests/<id>/status。
4. 狀態變為終止時，CLI 取得 GET .../requests/<id>/result，並將主機結尾為 .runcomfy.net 或 .runcomfy.com 的所有網址下載到 --output-dir。其他網址僅列出但不擷取。
5. 在輪詢期間按 Ctrl-C 會發送 POST .../requests/<id>/cancel，避免為已停止的 GPU 付費。

此技能不是什麼

不是自託管的 Flux 執行器。不是能力授予 — 依賴有效的 RunComfy 帳號。不是多租戶。

安全性與隱私

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