ComfyUI Node
Face Fix - Prepare Video and Anchors
Detects and tracks one primary face through a loaded video, makes a 512×512 face sequence, selects safe Z-Image anchors, and preserves the crop mapping needed to paste repaired faces back into the original frames.
Face Fix - Prepare Video and Anchors
- video_frames
- face_video_512
- anchor_images
- anchor_count
- anchor_indices
- face_fix_context
◄detection_confidence0.70►
◄crop_padding0.10►
◄minimum_face_pixels20►
◄rotation_assistLight: ±15°►
◄repair_distanceFar faces (recommended)►
◄custom_distance_threshold9.0►
◄anchor_interval16 frames (recommended)►
◄short_gap_tracking2►
CategoryVRGameDevGirl/Face Fix
Inputs (9)
| Name | Type | Default | Description |
|---|---|---|---|
| video_frames | IMAGE | Connect the IMAGE output from VHS Load Video. The complete batch is scanned for one primary face and retained for final full-resolution compositing. | |
| detection_confidence | FLOAT | 0.700.1–0.99 | Minimum confidence accepted from the face detector. Higher values reduce false detections but may miss small, blurry, profile, or motion-blurred faces. Lower cautiously for distant faces. Recommended starting value: 0.70. |
| crop_padding | FLOAT | 0.100–1.5 | Extra area around the detected face, measured as a fraction of face size on every side. Lower values crop closer to facial features; higher values include more hair, neck, and background. Recommended starting range: 0.10–0.25. |
| minimum_face_pixels | INT | 204–1024 | Reject detections whose width or height is smaller than this many source pixels. Raising this filters tiny false positives; lowering it permits very distant faces but increases false-detection risk. Recommended starting value: 20. |
| rotation_assist | COMBO | Light: ±15° | Also scans rotated copies of each frame, then maps detections back to the original coordinates. Light helps mildly tilted/overhead faces at roughly 3× detection work. Strong adds ±30° for difficult angles at roughly 5× detection work. It affects detection only; output frames are never rotated. |
| repair_distance | COMBO | Far faces (recommended) | Controls which face sizes are repaired. Very Far fully repairs below 4% of frame width and fades out by 6%. Far fully repairs below 7% and fades out by 9%. Far and Medium fully repairs below 10% and fades out by 12%. All disables distance filtering. Close faces above the fade limit remain unchanged and are not selected as Z-Image anchors. |
| custom_distance_threshold | FLOAT | 9.00.1–50 | Used only when Repair Distance is Custom. Faces at or above this percentage of frame width remain unchanged. Repair fades in across the 2 percentage points below this value. Example: 9% gives full repair at 7% or smaller, fading to no repair at 9%. |
| anchor_interval | COMBO | 16 frames (recommended) | Approximate spacing between Z-Image identity/detail anchors. Smaller intervals create more anchors and stronger consistency but take longer. Larger intervals are faster but give LTX less identity guidance. The nearest valid detected face is used, and boundary anchors are included automatically. |
| short_gap_tracking | INT | 20–8 | How many consecutive missed detections may reuse the last known face position. Strength fades across the gap. Use 0 to repair only freshly detected frames. The default 2 bridges brief blur without pasting a face into long no-face sections. |
Outputs (5)
| Name | Type | Description |
|---|---|---|
| face_video_512 | IMAGE | — |
| anchor_images | IMAGE | — |
| anchor_count | INT | — |
| anchor_indices | STRING | — |
| face_fix_context | VRGDG_FACE_FIX_CONTEXT | — |