Nodes/MiniMax H3 Audio T8/MiniMax H3 Face Refine Parity Stitch / 原版机制回贴 (Advanced)
ComfyUI Node

MiniMax H3 Face Refine Parity Stitch / 原版机制回贴 (Advanced)

The reference-mechanism stitch, bit-exact outside the mask

By T8mars·Created 20 days ago·Updated a day ago· 807
MiniMax H3 Face Refine Parity Stitch / 原版机制回贴 (Advanced)
  • base_frames
  • refined_crops
  • face_plan
  • candidate_frames
  • changed_mask
  • fallback_mask
  • fallback_count
  • report_json
paste_regionface_only
mask_dilation24
feather_source_px24.0
colour_match1.00
blend1.00
undetected_framesfade_out
max_face_mean_abs_delta1.00
processing_devicecpu_memory_safe

The parity-chain counterpart to Face Refine Stitch Audit: where the regular node uses a feather ellipse and a 0.65 color match, this one reproduces the reference mechanics verbatim - centred face rectangle, a chunk-midpoint 24px source feather, and post-warp source-coordinate colour match. Same idea as the practical stitch (paste the refined crops back, audit everything you didn't touch), but built so the result is directly comparable to the audited upstream recipe.

Mechanism details that define this node: paste_region defaults to face_only (a centred face rectangle, not an ellipse), mask_dilation (24) and feather_source_px (24) come from the reference's 24/24 recipe, and colour_match defaults to a full 1.0 - the reference applies it at full strength, and the parity chain keeps it that way. blend (1) scales the overall paste. If a frame's face change exceeds max_face_mean_abs_delta (1.0 here - deliberately loose, because the reference mechanism trusts the geometry), the frame's undetected_frames behavior kicks in, defaulting to fade_out.

The two things it guarantees: pixels outside the mask are audited bit-exact (nothing outside the face region changed, provably), and audio is never touched. It's a non-destructive review candidate - it doesn't overwrite your source or auto-accept anything.

Inputs: base_frames, refined_crops, and a face_plan of the parity type. Outputs: candidate_frames, changed_mask, fallback_mask, fallback_count, report_json. Like the practical stitch it's an output node - it ends a branch and hands you something to look at.

The honest caveat applies here more than anywhere in the chain: this node reproduces the recipe, and reproducing a recipe is not the same as reproducing quality. The mask geometry and feathering are audited; whether the reference mechanism actually beats the practical path is exactly the question this parity chain exists to answer, on your footage, with your eyes.

Use it as the sink for the parity chain: Parity Plan → Parity Latent → Per-Frame Denoise → this → Quality Gate → the MANUAL512 baseline for formal acceptance. If you don't care about reference comparison, the regular Stitch Audit is the one you'd actually ship with.

Install: ComfyUI Manager → "MiniMax H3 Audio T8", or:

cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/comfyui-minimax-h3-audio-T8

Restart after. No forced pip deps, no model downloads - pure CPU image work at the end of the chain.

CategoryT8/MiniMax H3/Quality/Experimental/Face Refine Parity

Inputs (11)

NameTypeDefaultDescription
base_framesIMAGE
refined_cropsIMAGE
face_planH3_T8_FACE_REFINE_PARITY_PLAN
paste_regionCOMBOface_only3 options: face_only, face_ellipse, full_crop_exp
mask_dilationINT240–256
feather_source_pxFLOAT24.00–256
colour_matchFLOAT1.000–1
blendFLOAT1.000–1
undetected_framesCOMBOfade_out3 options: fade_out, skip, composite_anyway
max_face_mean_abs_deltaFLOAT1.000.01–1
processing_deviceCOMBOcpu_memory_safe2 options: cpu_memory_safe, cuda_if_available

Outputs (5)

NameTypeDescription
candidate_framesIMAGE
changed_maskMASK
fallback_maskMASK
fallback_countINT
report_jsonSTRING