Nodul FaceDetailer (ComfyUI Impact Pack) în ComfyUI & Stable Diffusion / Flux

FaceDetailer (din ComfyUI Impact Pack) detectează automat fețele cu un model de detecție, le mărește, le regenerează cu un sampler și le lipește înapoi în imagine.

Intrări & ieșiri nod
FaceDetailer(image, model, clip, vae, guide_size=512, ..., denoise=0.5, bbox_detector, sam_model_opt=None, ...) -> image, cropped_refined, cropped_enhanced_alpha, mask, detailer_pipe, cnet_images

Nodul vine din pachetul custom ComfyUI-Impact-Pack (ltdrdata), categoria ImpactPack/Simple. Descrierea lui: detectează obiecte cu modele de detecție (bbox, segm, SAM), mărește zona găsită după guide_size și o regenerează. Este făcut pentru fețe, dar funcționează pentru orice inpainting automat, după modelul de detecție ales. Pe lângă imagine primește model, clip, vae, condiționările positive / negative și aceiași parametri ca un KSampler (seed, steps, cfg, sampler, scheduler, denoise).

Detectorul vine pe intrarea bbox_detector. Din Impact Pack V8.0, nodul UltralyticsDetectorProvider, care încarcă modelele YOLO, este în pachetul separat ComfyUI-Impact-Subpack și trebuie instalat separat. Modelele se pun în models/ultralytics/bbox (detecție) sau models/ultralytics/segm (segmentare); Bingsu/adetailer pe Hugging Face are, de exemplu, face_yolov8m.pt și hand_yolov8s.pt. Opțional, SAMLoader (Impact) dă un model SAM pe sam_model_opt, pentru o mască mai precisă.

Din V7.6 instalarea automată nu mai există: pachetul se instalează din Manager sau manual (git clone în custom_nodes, apoi pip install -r requirements.txt în mediul ComfyUI). Ieșirile sunt imaginea finală (image), lista zonelor regenerate, decupate (cropped_refined), aceleași zone cu canal alfa (cropped_enhanced_alpha), masca, un detailer_pipe pentru alte noduri Detailer și cnet_images. FaceDetailer (pipe) face același lucru cu intrările grupate, pentru mai multe treceri.

Concepte cheie și caracteristici

Concept / Parametru Descriere practică
guide_size / guide_size_for / max_size Mărimea la care se regenerează zona (implicit 512, raportată la bbox sau la zona decupată) și limita ei (implicit 1024).
denoise 0.0001–1.0, implicit 0.5: cât din zona detectată se regenerează.
feather Estomparea marginii la lipire, implicit 5.
bbox_threshold / bbox_dilation / bbox_crop_factor Pragul de detecție (0.5), extinderea casetei (10 px) și cât context se decupează în jurul ei (3.0).
sam_detection_hint / sam_threshold Cum se folosește SAM (implicit center-1) și pragul lui (0.93).
drop_size Ignoră detecțiile mai mici de atâția pixeli (implicit 10).
wildcard Prompt separat pentru zonele detectate.
cycle De câte ori se repetă regenerarea (1–10, implicit 1).
bbox_detector De la UltralyticsDetectorProvider (Impact Subpack).
sam_model_opt / segm_detector_opt Opționale: model SAM sau detector de segmentare.

Exemple practice și scenarii reale

Exemplul 1: Restaurarea fețelor după generare

models/ultralytics/bbox/face_yolov8m.pt

UltralyticsDetectorProvider (bbox/face_yolov8m.pt) -> FaceDetailer.bbox_detector
VAE Decode.IMAGE -> FaceDetailer.image
Load Checkpoint.MODEL/.CLIP/.VAE, CLIP Text Encode (+/-) -> FaceDetailer
FaceDetailer: guide_size 512, steps 20, denoise 0.5 -> Save Image

Exemplul 2: Același nod pentru mâini

UltralyticsDetectorProvider (bbox/hand_yolov8s.pt) -> FaceDetailer.bbox_detector

Exemplul 3: Instalare manuală (Impact Pack și Subpack)

cd ComfyUI/custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Impact-Pack comfyui-impact-pack
git clone https://github.com/ltdrdata/ComfyUI-Impact-Subpack
cd comfyui-impact-pack && pip install -r requirements.txt
cd ../ComfyUI-Impact-Subpack && pip install -r requirements.txt

Greșeli frecvente și capcane

  • Instalezi doar Impact Pack și nu găsești UltralyticsDetectorProvider. Din V8.0 este în ComfyUI-Impact-Subpack.
  • Cauți un nod „HandDetailer”. Nu există; folosești FaceDetailer cu un detector de mâini.
  • Pui denoise la 1.0 ca să „repari” fața. Zona se regenerează complet și poate să nu mai semene cu persoana sau cu unghiul inițial; pornește de la valoarea implicită 0.5 și ajustează.

Noțiuni și module înrudite