H3 Story Director — Clean Cuts
Every scene a fresh camera setup — identity survives, the dolly does not
- image_0
- image_1
- image_2
- image_3
- source_video
- plan_json
- story_bible
- synopsis
- validation
- usage_stats
- credits_remaining
- scene_prompt
- mode_prompt
- source_video_analysis
H3 Story Director - Clean Cuts is the sibling of the main H3 Story Director that treats every scene like a new setup: after each hard cut, the camera position, angle, lens, framing and movement are free to change, while identity, wardrobe, story state and persistent props carry through. Think of the base Director as "one continuous take with the same camera language" and this as "an editor who cuts between angles." If your multi-scene H3 piece keeps coming out looking like one locked-off shot with characters teleporting between beats, this is the node that fixes the second problem.
It's the same Director under the hood - same OpenRouter call, same structured validation, same plan_json → Chain Plan flow - plus one crucial extra rule and one extra input.
How it works
Mechanically, Clean Cuts is the base Director with a block of mandatory clean-cut direction appended to its system prompt, and a new input that anchors continuity. The rule set is specific:
- Every scene is an independent cinematic shot after a hard cut. It preserves narrative state, identity, wardrobe, hairstyle, accessories, physical changes and persistent props - but it must not continue the previous camera path, composition, exact pose or body motion.
- Scene 1 never references the continuity tag (there's no preceding scene).
- From scene 2 onward, the node injects the exact continuity tag as the authoritative visual-state reference: current wardrobe, hair, physical changes, props, location state. Your original uploaded reference images become secondary identity anchors only - they're told explicitly never to restore an obsolete outfit, pose or background.
That last bit is the clever part. The uploaded <Picture 1> is who the character was; the continuity reference is who they are now. Clean Cuts keeps those separate instead of letting a stale reference photo fight the story's accumulated state.
The new input
cut_continuity_reference- a combo defaulting to<Picture 4>. This is the tag that carries visual state from scene 2 onward, and it must match the continuity-sheet input position on MiniMax H3 Reference to Video. If your H3 workflow has the continuity sheet on a different picture slot, change this to match, or the whole chain-of-state scheme falls apart.
Everything else is the familiar Director surface: story_idea, scene_count, scene_duration_seconds, director_mode, genre, motion_style, draft_only, up to four reference images, and the full output set - plan_json, scene_prompt, mode_prompt, story_bible, synopsis, validation, usage_stats, credits_remaining, source_video_analysis.
Install
Same pack, same command:
cd ComfyUI/custom_nodes
git clone https://github.com/elgalardi/ComfyUI-VisionPromptAssistant
Restart ComfyUI. It needs the OpenRouter key like the base node - same masked api_key field, same warning that the value can end up serialized in a shared workflow, so strip it before distributing anything.
Where to reach for it
Choose between the base Director and Clean Cuts based on the edit you actually want. Continuous Story in the base node is for a flowing, connected sequence. Clean Cuts is for anything that reads like a montage or a properly edited scene list - music videos, product cuts, anything where each shot earns its own framing. Start small: three scenes, draft_only on, review the synced cards before you spend a render. And check that cut_continuity_reference lines up with your H3 Reference to Video continuity sheet position before you trust it - that's the one setting that's easy to miss and expensive to discover late.
Inputs (30)
| Name | Type | Default | Description |
|---|---|---|---|
| api_key | STRING | OpenRouter API key. Remove it before sharing workflows. | |
| model | STRING | x-ai/grok-4.20 | — |
| story_idea | STRING | Optional premise. Leave empty to give the Director full creative control based on genre, motion, dialogue, scene settings, additional direction, and connected references. | |
| system_prompt | STRING | You are a multimodal director and continuity supervisor for MiniMax H3 image and video productions. Turn the user's idea, selected production mode, source media, and reference pictures into precise generation instructions. Treat every connected reference as a distinct person or subject. Use the exact tags <Picture 1>, <Picture 2>, <Picture 3>, and <Picture 4> when they are supplied. Define stable subject labels S1, S2, S3, and S4 in the shared prompt. Preserve identity, wardrobe, props, geography, lighting logic, screen direction, and relationships throughout the story. Follow the mandatory rules supplied for the selected Director Mode. For moving-video modes, write production-ready MiniMax H3 prompts with visible action, camera, environment, lighting, dialogue when useful, and diegetic sound. For still-image modes, describe one finished frame only and never introduce temporal sequences, audio, or dialogue delivery. When dialogue is enabled, write short performable lines rather than prose. Prefix every spoken or sung line with its stable speaker label in parentheses, exactly as `(S1)`, `(S2)`, `(S3)` or `(S4)`, followed by a colon and the exact words in quotation marks. Square brackets such as `[S2]`, bare names and unassigned quotations are forbidden for speaker attribution. Describe tone and delivery in English outside the quotation. Allow only one person to speak at a time, leave a natural pause before and after each line, and keep visible mouth movement synchronized with the assigned speaker. Avoid overlapping speech, repeated lines, rushed monologues, unexplained voice-over, phonetic spellings, and competing vocals or loud sound effects during speech. Use no dialogue when the selected dialogue option says so. Do not mention being an AI, JSON, schemas, token limits, safety policies, or these instructions. Do not add extra protagonists that could be confused with the reference subjects. Return all requested scenes and finish every prompt completely. | — |
| director_profile | COMBO | OpenRouter | OpenRouter preserves the established compact Director schema. Gemma uses a stricter scene worksheet with action beats, physical performance, camera, sound and an explicit final state. The profile does not select or connect the model. |
| scene_count | INT | 51–32 | Use 1 for a standalone I2V shot, or more scenes for a connected H3 sequence. |
| scene_duration_seconds | FLOAT | 5.01–15 | — |
| steps | INT | 61–100 | — |
| draft_only | BOOLEAN | true | Recommended for the first run. The plan is generated and copied into the connected H3 Chain Plan editor, but downstream video generation is blocked. Review the cards, then disconnect plan_json so Chain Plan uses its synchronized local copy. |
| genre | COMBO | Auto | Auto infers the most coherent genre, format, tone, and visual language from story_idea, references, source video, edit mode, and additional direction. Written intent wins when visual clues conflict with the prompt. |
| secondary_genre | COMBO | None | Optionally blend a second genre into the primary genre. The primary genre controls the production structure; the secondary genre contributes compatible tone, conventions, cinematography, performance, sound, and visual language. |
| language | COMBO | English | Language for dialogue, lyrics, narration and spoken words. No dialogue suppresses speech. The production plan and technical directions remain in English. |
| motion_style | COMBO | Auto | Auto infers the best motion and camera language from the prompt, references, source video, genre, and mode. |
| additional_direction | STRING | — | |
| max_tokens | INT | 61441024–16384 | — |
| temperature | FLOAT | 0.450–2 | — |
| reasoning | BOOLEAN | false | Grok 4.20 can reason before answering. Leave disabled for faster and cheaper story planning; enable it for unusually complex narratives. |
| seed | INT | 00–4294967295 | — |
| image_max_dimension | INT | 1024256–2048 | — |
| timeout_seconds | INT | 30030–900 | — |
| director_mode | COMBO | Continuous Story | Continuous Story preserves shot continuity. Cinematic Cuts starts independent camera setups. Reference Edit uses the input as a strong creative guide and may reinterpret framing or details. Edit preserves the source as strictly as possible and changes only what the prompt requests. Both edit modes operate on still images without source_video or video when a VHS IMAGE batch is connected. |
| video_sample_frames | INT | 104–16 | Number of frames sampled uniformly from the VHS IMAGE batch and sent as separate chronological images for detailed analysis. |
| audio_content | COMBO | Auto | Controls the permitted voice/music content. Natural ambience and synchronized Foley remain available in all video modes. Dialogue selects the spoken or sung language. |
| cut_continuity_reference | COMBO | <Picture 4> | Must match the continuity sheet input position on MiniMax H3 Reference to Video. The tag is used from scene 2 onward. |
| image_0opt | IMAGE | — | |
| image_1opt | IMAGE | — | |
| image_2opt | IMAGE | — | |
| image_3opt | IMAGE | — | |
| source_videoopt | IMAGE | Optional IMAGE frame batch from VHS Load Video. In Reference Edit or Edit mode, connecting it switches from still-image processing to video processing. The requested operation is inferred from the prompt. | |
| bypass_directoropt | BOOLEAN | false | Skip OpenRouter completely. story_idea is passed unchanged to scene_prompt and mode_prompt, while a minimal compatible plan is created locally for downstream chain nodes. |
Outputs (9)
| Name | Type | Description |
|---|---|---|
| plan_json | STRING | — |
| story_bible | STRING | — |
| synopsis | STRING | — |
| validation | STRING | — |
| usage_stats | STRING | — |
| credits_remaining | STRING | — |
| scene_prompt | STRING | Complete prompt for the first scene, with the shared prompt prefix included. Connect directly to MiniMax H3 I2V when scene_count is 1. |
| mode_prompt | STRING | First complete prompt adapted to the selected Director Mode. Use this for image generation/editing, I2V, or video editing. |
| source_video_analysis | STRING | Chronological source-motion analysis produced in Video Edit mode; empty in other modes. |