Nodes/MiniMax H3 Audio T8/MiniMax H3 Motion Quality Audit / 高速动态质量审计 (Advanced)
ComfyUI Node

MiniMax H3 Motion Quality Audit / 高速动态质量审计 (Advanced)

A dependency-free audit that flags shaky, frozen or mushy H3 footage

By T8mars·Created 20 days ago·Updated a day ago· 807
MiniMax H3 Motion Quality Audit / 高速动态质量审计 (Advanced)
  • frames
  • face_mask
  • risk_detected
  • risk_range_count
  • risk_ranges_json
  • report_json
fps24.00
roi_modefull_frame
roi_x0.25
roi_y0.05
roi_width0.50
roi_height0.50
sharpness_ratio_floor0.55
temporal_instability_multiplier2.5
high_motion_delta_floor0.030
freeze_delta_ceiling0.002
repair_context_frames12

Sometimes you don't need to know why H3's motion went wrong - you just need to know where, so you can rerender or repair it. MiniMaxH3MotionQualityAuditT8Advanced is a temporal proxy audit: feed it decoded frames and it scores them for the failure modes that actually plague fast H3 output - sharpness drops, temporal instability, high-motion smearing, and frozen frames - then hands you the risky ranges as a report.

Read the description carefully, because the author is meticulous about scope. It's read-only and has no external dependencies - no SAM, no face model, no ML model to download. It doesn't claim face identity detection, and it never changes, uploads, or auto-accepts media. If you want face-focused analysis, you supply a reviewed face/subject mask yourself, or a manual ROI. This is a proxy audit, not a judgment; its output is designed to feed a repair plan, not to be a final verdict.

Inputs that matter

  • frames and fps - what you're auditing. fps defaults to 24.
  • roi_mode - full_frame (default), manual_static_roi, or connected_mask. For faces, use a mask; the roi_x/y/width/height fields only apply to manual ROI mode.
  • sharpness_ratio_floor (0.55) - below this, the region is considered soft.
  • temporal_instability_multiplier (2.5) - how jumpy counts as jumpy.
  • high_motion_delta_floor (0.03) and freeze_delta_ceiling (0.002) - the smearing and frozen-frame gates.
  • repair_context_frames (12) - how much context around a flagged range gets included when the result becomes a repair plan.
  • face_mask (optional) - reviewed face/subject mask for face-focused analysis.

Outputs

risk_detected (boolean), risk_range_count, risk_ranges_json (the list of flagged ranges), and report_json. It's an output node, so it can terminate a graph and hand its findings to a human (or to the Repair Plan node).

Install and where it fits

Pack install, once: ComfyUI Manager → search MiniMax H3 Audio T8, or git clone https://github.com/T8mars/comfyui-minimax-h3-audio-T8 into ComfyUI/custom_nodes/, restart. No pip extras. This one is refreshingly dependency-free - no models to place, which makes it the cheapest node in the whole Motion Recovery family to try.

Use it as your "was that footage good or not?" gate before spending compute on repair. Wire risk_ranges_json into MiniMaxH3MotionRepairPlanT8Advanced and it becomes a non-destructive repair plan; or just read it and rerender manually. The honest caveat: it's a proxy - "risk detected" means the numbers look bad, and a face-specific audit needs a mask you actually reviewed. And like everything in this pack's quality corner, it's Experimental and fails closed by design, so trust its "no risk" verdict less than you trust its "risk" verdict.

CategoryT8/MiniMax H3/Quality/Experimental

Inputs (13)

NameTypeDefaultDescription
framesIMAGE
fpsFLOAT24.000.01–240
roi_modeCOMBOfull_frame3 options: full_frame, manual_static_roi, connected_mask
roi_xFLOAT0.250–1
roi_yFLOAT0.050–1
roi_widthFLOAT0.500.01–1
roi_heightFLOAT0.500.01–1
sharpness_ratio_floorFLOAT0.550.01–1
temporal_instability_multiplierFLOAT2.51–100
high_motion_delta_floorFLOAT0.0300–1
freeze_delta_ceilingFLOAT0.0020–1
repair_context_framesINT120–3600
face_maskoptMASK

Outputs (4)

NameTypeDescription
risk_detectedBOOLEAN
risk_range_countINT
risk_ranges_jsonSTRING
report_jsonSTRING