Nodes/comfyui-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 2 months ago·Updated about 8 hours ago· 1,158
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_framesINT12—
face_maskoptMASK—

Outputs (4)

NameTypeDescription
risk_detectedBOOLEAN—
risk_range_countINT—
risk_ranges_jsonSTRING—
report_jsonSTRING—