ComfyUI-MiniMax-H3-Promptor v1.3.0: Full-reference scene staging, zero-deformation list expansion & in-node drop zone
Hey everyone,
If you’ve spent any time working with multi-reference video prompting in ComfyUI (especially with MiniMax Hailuo / H3), you probably know the frustration:
You feed in 3–4 reference images hoping for a cohesive 15-second cinematic shot, and the LLM spits out a rushed single-shot prompt where characters overlap chaotically, faces get stretched, pacing flickers, and dialogue cuts off halfway through.
Our team at 1038lab just pushed a massive overhaul to ComfyUI-MiniMax-H3-Promptor (v1.3.0). We threw out the old "single-shot rush" approach and re-engineered the prompt pipeline to work like an actual film production crew.
Here is what we added in v1.3.0:
1. Two-Stage Hollywood AI Director & Screenwriter
Instead of rushing the final prompt in one go, the node now executes in two deliberate stages:
- Stage 1 (Director Blueprint & Global Vibe): The LLM acts as the showrunner. It analyzes all your cast references, maps out spatial layers (Foreground, Midground, Background), sets lighting palettes, and calculates shot pacing (enforcing a 2.5s–4.0s minimum per shot to prevent pacing flicker).
- Stage 2 (Storyboard & Dialogue): Using that approved blueprint, it crafts timed cuts covering the full duration (up to 15.0s) and injects official MiniMax character dialogue syntax (<Subject 1> (S1) [angry] says: <d>[EN] "..."</d>).
If you pass in a custom scene prompt, the engine treats it as the supreme mandate, directing your uploaded cast and props to execute your exact vision.
2. In-Node HTML Drop-Zone (No More Noodle Spaghetti)
Wiring up 5+ image loader nodes for multi-character setups makes workflows messy fast. We replaced the PyTorch image input slots with an interactive in-node HTML/JS drag-and-drop panel. You can drop images, video references, and audio files straight onto the node canvas.
3. Vision Analyzer V2: Native Aspect Ratios & 50% Lower Token Cost
- Zero-Deformation List Expansion (OUTPUT_IS_LIST): Passes references in their 100% original dimensions through native list iteration. No forced letterboxing, cropping, or distorted face proportions.
- Pure Perception Engine: We stripped out redundant text synthesis so the VLM only extracts raw visual traits (clothing, colors, contours, OCR). This cut API token usage and latency roughly in half.
4. Quality-of-Life & Stability Upgrades
- Smarter Entity Regex: Fixed false positives so items like a "cat-ear headband" are recognized as accessories on a person rather than spawning wild animals into your scene.
- Sub-Batch Chunking: Set custom Max Batch Images limits with positional fallback keys to respect upstream API rate limits without workflow crashes.
- Real-Time Terminal Execution Trace: Clean phase banners in the ComfyUI terminal let you monitor the Blueprint -> Storyboard -> Assembly stages live.
💡 A Note on APIs: 100% Free & Local-Friendly (No Paid API Required!)
We’ve noticed some users hesitate whenever they hear "LLM/VLM API," assuming it requires paid subscriptions or goes against the open-source ethos. That is not the case here!
Our node is fully customizable and seamlessly supports:
- 100% Free Local Models: Plug directly into Ollama, LM Studio, or llama.cpp to run any open-source model from Hugging Face locally on your own GPU.
- Free Cloud Tiers: If you don't want to run local LLMs, services like OpenRouter, Groq, and NVIDIA NIM offer generous free tiers/credits that are more than enough for daily video prompting.
Setup takes just a few clicks—use whatever setup works best for your hardware and budget.
Links & Getting Started
- 📦 GitHub Repository: https://github.com/1038lab/ComfyUI-MiniMax-H3-Promptor
- 📝 Full v1.3.0 Changelog: https://github.com/1038lab/ComfyUI-MiniMax-H3-Promptor/blob/main/updates.md#v130-20260818
You can update directly inside ComfyUI Manager or run a git pull in your custom nodes directory.
We’d love to hear your thoughts, bug reports, and workflow suggestions!
