relight

Relight

改變靜態影像的光線——方向、色溫、強度、氛圍——無需重拍。此技能會路由至 Qwen Edit 2509 專用的 relight LoRA（當需要目的性打光端點時），或路由至保留主體身份的編輯端點（當文字描述足夠時）。

runcomfy.com · Qwen Edit relight · CLI 文件

由 RunComfy CLI 驅動

# 1. 安裝（詳見 runcomfy-cli 技能）
npm i -g @runcomfy/cli      # 或： npx -y @runcomfy/cli --version

# 2. 登入
runcomfy login              # 或在 CI 中： export RUNCOMFY_TOKEN=<token>

# 3. 重新打光
runcomfy run qwen/qwen-edit-2509/lora/relight \
  --input '{"image": "...", "prompt": "..."}' \
  --output-dir ./out

CLI 深入介紹：runcomfy-cli 技能。

---

選擇合適的模型

依最新到最舊列出。

Qwen Edit 2509 Relight LoRA — qwen/qwen-edit-2509/lora/relight （預設用於專用打光）

基於 Qwen Edit 2509 的專用打光 LoRA。專門針對改變光線方向、色溫、強度和氛圍進行調校，同時保留主體身份、姿勢和構圖。
適用於：精確光線控制（「左側黃金時刻主光、右側柔光補光、無邊緣光」）、品牌產品重新打光、人像氛圍轉換。
避免用於：非關光線的編輯——請使用通用影像編輯。

Nano Banana 2 Edit — google/nano-banana-2/edit

透過空間/文字描述驅動的保留主體身份編輯。透過提示詞改變光線："convert to golden hour with warm key light from the left"。
適用於：作為更廣泛編輯流程一部分的光線改變（同時更換背景、添加物件）。
避免用於：僅需重新打光且追求最高光線保真度時——請使用 Qwen Edit Relight。

GPT Image 2 Edit — openai/gpt-image-2/edit

多參考編輯；可參考具有目標光線風格的影像並套用。
適用於：「比對這張參考照片的光線」工作流程，搭配明確的參考影像。
避免用於：純文字光線描述——Qwen Edit Relight 更佳。

FLUX Kontext Pro — blackforestlabs/flux-1-kontext/pro/edit

單一指令、高保留度。使用格式："Keep everything exactly. Change the lighting to soft window light from the left, late-afternoon warm temperature."
適用於：對單張影像進行精準光線微調，不影響其他部分。

---

路線 1：Qwen Edit Relight — 預設

模型：qwen/qwen-edit-2509/lora/relight
目錄：Qwen Edit relight · qwen-image 集合

呼叫

runcomfy run qwen/qwen-edit-2509/lora/relight \
  --input '{
    "image": "https://your-cdn.example/product.jpg",
    "prompt": "Relight as golden-hour studio: warm 3200K key light from camera-left at 45°, soft cool fill from right, no rim light, preserve product orientation and color identity."
  }' \
  --output-dir ./out

提示技巧

• 先說明光線類型，再量化：
  • 光源："golden hour"、"studio softbox"、"overcast diffuse"、"single hard spotlight"、"window light"、"blue hour"
  • 色溫："warm 3200K"、"neutral 5500K"、"cool 6500K"
  • 方向："camera-left at 45°"、"top-down"、"3/4 from right"、"behind subject (rim)"
  • 強度："soft"、"hard"、"high-contrast"、"flat"
• 明確說明保留內容："preserve subject pose, framing, and color identity" — 若無此句，模型可能偏離。
• 組合多光源設定："key light from left, soft fill from right, hair rim from behind"。
• 時段捷徑有效："golden hour" / "blue hour" / "high-noon" / "overcast afternoon" 皆會解析為正確的色溫與柔和度。

---

路線 2：基於描述的編輯（無 relight LoRA）

當 Qwen Relight 不適用時（例如複合編輯包含其他變更），使用 Nano Banana 2 Edit：

runcomfy run google/nano-banana-2/edit \
  --input '{
    "prompt": "Keep the subject and pose exactly. Relight as soft window light from the left, late-afternoon warm color temperature. Add subtle shadow on the right side of the face.",
    "image_urls": ["https://your-cdn.example/portrait.jpg"]
  }' \
  --output-dir ./out

更廣泛的編輯處理請參見 image-edit。

---

常見模式

產品重新打光（白盒 → 情境照）

• Qwen Edit Relight 搭配 "warm window light from camera-left, soft shadow on counter, late-afternoon temperature, preserve product orientation"

人像氛圍轉換

• Qwen Edit Relight 搭配 "golden hour rim from behind, warm soft key from front-left, preserve identity"

風景照時段轉換

• Nano Banana 2 Edit 搭配文字描述——風景重新打光受益於更廣泛的場景上下文處理

比對參考照片風格

• GPT Image 2 Edit 搭配 images: [source, lighting-reference] 和 "Apply the lighting (direction, color temperature, contrast) of image 2 to image 1. Preserve image 1's subject identity."

多影像批次重新打光（整個 SKU 圖庫統一光線）

• Nano Banana 2 Edit 搭配 image_urls 陣列——同一光線提示詞套用至整批

此技能不涵蓋的功能

• 從頭生成——請參見 ai-image-generation。
• 影片重新打光——RunComfy 有 ComfyUI 工作流程用於產品/影片重新打光（IC-Light 變體）；CLI 端點目前僅支援影像。請參閱 runcomfy.com/comfyui-workflows 了解 IC-Light 影片工作流程。

---

瀏覽完整目錄

• qwen-image 集合 — Qwen Edit 基礎模型 + LoRA 變體（relight、skin 等）
• best-image-editing-models 集合
• 訓練自訂 relight LoRA — 將品牌的光線風格捕捉為 LoRA，並在重新打光時套用

---

退出碼

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

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

運作方式

此技能在專用打光時選擇 Qwen Edit Relight LoRA，當重新打光為複合編輯的一部分時回退至更廣泛的編輯端點。CLI 向 Model API 發送 POST 請求，輪詢請求狀態，並將結果下載至 --output-dir。

安全性與隱私

• 僅透過驗證過的套件管理器安裝。 使用 npm i -g @runcomfy/cli 或 npx -y @runcomfy/cli。代理程式不得代表使用者將任意遠端安裝腳本導入 shell。
• Token 儲存：runcomfy login 將 API token 寫入 ~/.config/runcomfy/token.json，權限設為 0600。在 CI/容器中設定 RUNCOMFY_TOKEN 環境變數。
• 輸入邊界（shell 注入）：提示詞和影像 URL 透過 --input 以 JSON 字串傳遞。CLI 不會對提示詞內容進行 shell 展開。無 shell 注入風險。
• 間接提示詞注入（第三方內容）：來源影像 URL 為不可信任。代理程式緩解措施：
  • 僅攝取使用者明確提供用於此重新打光的 URL。
  • 當重新打光結果偏離提示詞時，懷疑參考素材。
• 對外端點（白名單）：僅 model-api.runcomfy.net 和 *.runcomfy.net / *.runcomfy.com。無遙測。
• 生成檔案大小上限：CLI 會中止任何超過 2 GiB 的單一下載。
• bash 使用範圍：僅限 Bash(runcomfy *)。

另請參閱

• runcomfy-cli — 底層 CLI
• image-edit — 完整影像編輯路由器
• ai-image-generation — 文字轉影像 / 影像轉影像路由器
• image-inpainting — 遮罩驅動的區域編輯