comfyui-workflows/optimized/image-to-video/minimax-h3-r2v-master/README.md

MiniMax H3 R2V Master

Summary

Best-current MiniMax H3 reference-first generation master for Chris's actual priority: reference-to-video first, not generic t2v. This maintained version now promotes the quality features from the Chris working graph: second-pass enhancement enabled, RTXVideoSuperResolution enabled, and the non-Heretic AWQ text-encoder path.

Status

• best-current-r2v-master

Workflow asset

• workflow.json
• api-prompt.json
• prompt-guide.md
• prompt-template.md
• references/default-character-reference.jpg
• references/default-location-reference.jpg
• references/default-location-reference.url

This pass

• Promoted the Chris working quality lane into the maintained master.
• Enabled the built-in 2 Pass path.
• Enabled the built-in HIGH QUALITY path so RTXVideoSuperResolution runs.
• Swapped away from the Heretic text encoder to the AWQ MiniMax encoder path.
• Kept the prompt structure generic and reusable for the single-clip ref2v lane.

Built from

• custom/chris/minimax-h3-extender-working/
• current MiniMax Ref2VA prompt guidance in optimized/notes/minimax-h3-ref2va-prompt-guidelines.md
• local MiniMax continuation lessons gathered from earlier optimized ref2v and Contex Loop experiments
• official MiniMax H3 docs for prompt relationships, role labels, and limits

Key model stack

• minimax_h3_ref2va_pruned_int8_convrot.safetensors
• qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors
• minimax_h3_video_vae_int8_convrot.safetensors
• minimax_h3_audio_vae_fp32.safetensors
• minimax\minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors

Main changes

• keeps the safer 864x480 working canvas for the main ref2v lane
• uses the AWQ MiniMax text encoder instead of the Heretic path
• enables the graph's 2 Pass lane
• enables the graph's HIGH QUALITY lane so RTXVideoSuperResolution runs
• sets the RTX upscale multiplier to 2x
• keeps Sol Attn enabled in the promoted working graph
• keeps generic reusable prompt text in the single-clip lane
• replaces the old Chris-specific continuation plan with a generic three-shot starter

Current working settings

• main ref2v resolution: 864x480
• source timeline basis: 24 fps
• main scheduler lane: simple
• standard sampler option present: euler_ancestral
• high-quality sampler option present: euler_ancestral_cfg_pp
• second-pass denoise in the promoted working graph: 0.4
• starter continuation plan defaults: 10s clips, 8 plan steps
• RTX upscale: 2x, ULTRA

API submission

• workflow.json is the maintained front-end graph and still includes helper nodes that ComfyUI rejects when you post the raw graph directly to /prompt.
• api-prompt.json is the server-safe prompt-style export for direct API submission.
• scripts/queue-minimax-r2v-duration-sweep.mjs uploads the bundled scene + character refs and queues the 2s/5s/8s/12s/15s/17s/20s duration sweep with first-pass steps set to 8 by default.
• On the current 8 GiB test box, the corrected default-reference sweep completed successfully through 17s; the 20s run failed with a GPU out-of-memory error. Treat 17s as the current verified upper bound for this exact local setup unless the workflow or hardware changes.

When to use this

• use this first when the goal is: keep one or more reference images stable and generate a higher-quality MiniMax H3 ref2v clip with the current quality passes enabled
• use optimized/image-to-video/minimax-h3-extension-master/ instead when the main job is extending an already existing source video rather than generating a new reference-driven chain

Notes

• This master is now heavier than the older lightweight w4a8 / Heretic lane.
• It is the quality-biased ref2v path, not the cheapest local-safe path.
• The graph still carries extra continuation machinery from the promoted Chris working workflow, but the maintained ref2v lane is the generic single-clip starter built around the reusable prompt block and quality passes.
• Use prompt-guide.md for the short authoring rules and prompt-template.md for a copy-ready starter block that matches this maintained workflow.
• Default bundled <Picture 1> scene reference: references/default-location-reference.jpg
• Optional provenance note for the scene reference: references/default-location-reference.url
• Default bundled Subject 1 character reference: references/default-character-reference.jpg
• Verified corrected-reference duration sweep on 2026-08-22: 2s, 5s, 8s, 12s, 15s, and 17s passed; 20s failed on VRAM.