bruxosdovfx - Camera H3 v19.1

Visual camera editor for MiniMax H3 inside ComfyUI.

Drag the camera, create keyframes, and generate camera-path prompts for H3.

The node compiles prompts. It is not a geometric camera adapter, so H3 can still miss angle, timing, or scale.

Installation

cd ComfyUI/custom_nodes
git clone https://github.com/NyckM/3d-Camera-control-H3-Minimax.git

Restart ComfyUI and search for:

bruxosdovfx • Camera H3

What's new in v19.1

• Smooth - smoother motion between keyframes.

• Linear - linear motion per segment.

• Redistribute Timing - balances average speed between keyframes.

• Unwrap - converts crossings such as 350° -> 10° to the short arc.

• Start / End Hold - adds a 0.5 second hold.

• Presets - orbit, rise, fall, move closer, move away, and static camera.

• Diagnostics - detects holds, static paths, and zero crossings.

• Loop Closure - auto closes compatible orbits; off disables it.

• UI Language - Portuguese / English interface and diagnostics.

Basic use

• Drag the purple camera to orbit.

• Mouse wheel changes distance.

• Drag the background to rotate the preview only.

• Use keyframes to build the path.

• Pure Orbit resets elevation while keeping the orbit.

• Play previews the planned camera path.

The preview shows the planned trajectory, not the final H3 result.

Main connections

H3 Edit

• compiled_prompt -> H3 Edit Text Encode

• options -> H3 Edit Text Encode

• reference_first -> H3 Edit source image

• length -> generation length

• fps -> video output FPS

Use compiled_prompt and options together.

Native H3 / Ref2VA

• Use minimax_prompt instead of compiled_prompt.

Subject Box

subject_box tells the model who the camera should orbit around.

If empty, the image center is used as the reference target.

If filled, it identifies the subject position in the first frame.

Example:

[L=0.62, T=0.18, W=0.24, H=0.55]

• L - left position

• T - top position

• W - width

• H - height

Values range from 0 to 1.

Easy setup

Add:

bruxosdovfx • H3 Subject Box

Connect your image to reference_image, draw the box over the subject, and connect its subject_box output to Camera H3.

This is especially useful when the subject is off-center.

It does not crop, zoom, move the camera, or track the subject. It only identifies the orbit target in the first frame.

Freeze Frame

Use a still image or reference frame.

• Connect reference_image.

• freeze_index selects the frame from the batch.

• Connect reference_first to the H3 Edit source image.

• Connect compiled_prompt and options to the H3 Edit encoder.

With native H3, use minimax_prompt plus the first frame in an FL2VA workflow.

Motion Frame

Use a video or frame sequence as motion reference.

• Reference length: 2-15 seconds.

• Set the real FPS in source_fps.

• Use scene coverage | camera path.

• Use an H3 Ref2VA model.

• Use bruxosdovfx • H3 Motion Reference.

Connections:

• reference_frames -> reference_frames

• minimax_prompt -> prompt

• length -> length

• Qwen H3 encoder -> clip

• H3 video VAE -> vae

The reference is converted to 24 fps and trimmed to the format expected by H3.

Original audio is not forwarded.

Interpolation

Smooth

Smoothed camera motion. With extended contracts, movement stays more continuous between waypoints.

Linear

Straight interpolation between keyframes.

Timing

Video timing uses the timestamp of the last visible frame:

(length - 1) / fps

Redistribute Timing adjusts keyframe timing for more even average camera speed.

Loop Closure

loop_closure = auto can anchor the last frame to the first when the path is compatible.

Usually ON when:

• Freeze Frame is active.

• scene coverage | camera path is used.

• Orbit is exactly +360° or -360°.

• Final elevation matches the start.

• Final distance matches the start.

• A reference image is connected.

OFF when:

• Orbit is 359°.

• Orbit is 720°.

• Motion Frame is used.

• A still-image angle task is used.

• Final elevation or distance is different.

• loop_closure = off.

Close Orbit adjusts the final pose so the path closes correctly.

Main controls

• ui_language - interface language.

• camera_trajectory - time, azimuth, elevation, and distance keyframes.

• instruction - extra prompt instruction.

• subject_box - identifies the subject and orbit target in the first frame.

• orbit_direction - corrects the direction sent to H3.

• elevation_range - vertical control range.

• subject_framing - records close-up, medium, or wide framing.

• minimax_format - controls minimax_prompt formatting.

• prompt_detail - baseline or extended contracts.

• runtime_task - video camera path or new still-image angle.

subject_framing does not apply zoom or cropping.

Outputs

• compiled_prompt - prompt for H3 Edit.

• options - H3 Edit options.

• minimax_prompt - alternative prompt for native H3.

• storyboard_json - camera-path data.

• info - diagnostics.

• length - frame count.

• fps - output FPS.

• h3world_actions - approximate pan / tilt action text.

Limitations

• H3 can still miss angle, scale, or timing.

• The preview does not simulate the generated result.

• Empty subject_box uses the image center as reference target.

• Motion Frame depends on Ref2VA preserving the source action.

• h3world_actions describes approximate pan / tilt behavior, not a true geometric orbit.

Credits

Node by Bruxos do VFX.

Based on the H3 Edit integration from:

https://github.com/ethanfel/ComfyUI-MiniMax-H3-Edit

Repository:

https://github.com/NyckM/3d-Camera-control-H3-Minimax

Visual camera editor for MiniMax H3 inside ComfyUI.

Drag the camera, create keyframes, and generate camera-path prompts for H3.

The node compiles prompts. It is not a geometric camera adapter, so H3 can still miss angle, timing, or scale.

Installation

cd ComfyUI/custom_nodes
git clone https://github.com/NyckM/3d-Camera-control-H3-Minimax.git

Restart ComfyUI and search for:

bruxosdovfx • Camera H3

What's new in v19.1

• Smooth - smoother motion between keyframes.

• Linear - linear motion per segment.

• Redistribute Timing - balances average speed between keyframes.

• Unwrap - converts crossings such as 350° -> 10° to the short arc.

• Start / End Hold - adds a 0.5 second hold.

• Presets - orbit, rise, fall, move closer, move away, and static camera.

• Diagnostics - detects holds, static paths, and zero crossings.

• Loop Closure - auto closes compatible orbits; off disables it.

• UI Language - Portuguese / English interface and diagnostics.

Basic use

• Drag the purple camera to orbit.

• Mouse wheel changes distance.

• Drag the background to rotate the preview only.

• Use keyframes to build the path.

• Pure Orbit resets elevation while keeping the orbit.

• Play previews the planned camera path.

The preview shows the planned trajectory, not the final H3 result.

Main connections

H3 Edit

• compiled_prompt -> H3 Edit Text Encode

• options -> H3 Edit Text Encode

• reference_first -> H3 Edit source image

• length -> generation length

• fps -> video output FPS

Use compiled_prompt and options together.

Native H3 / Ref2VA

• Use minimax_prompt instead of compiled_prompt.

Subject Box

subject_box tells the model who the camera should orbit around.

If empty, the image center is used as the reference target.

If filled, it identifies the subject position in the first frame.

Example:

[L=0.62, T=0.18, W=0.24, H=0.55]

• L - left position

• T - top position

• W - width

• H - height

Values range from 0 to 1.

Easy setup

Add:

bruxosdovfx • H3 Subject Box

Connect your image to reference_image, draw the box over the subject, and connect its subject_box output to Camera H3.

This is especially useful when the subject is off-center.

It does not crop, zoom, move the camera, or track the subject. It only identifies the orbit target in the first frame.

Freeze Frame

Use a still image or reference frame.

• Connect reference_image.

• freeze_index selects the frame from the batch.

• Connect reference_first to the H3 Edit source image.

• Connect compiled_prompt and options to the H3 Edit encoder.

With native H3, use minimax_prompt plus the first frame in an FL2VA workflow.

Motion Frame

Use a video or frame sequence as motion reference.

• Reference length: 2-15 seconds.

• Set the real FPS in source_fps.

• Use scene coverage | camera path.

• Use an H3 Ref2VA model.

• Use bruxosdovfx • H3 Motion Reference.

Connections:

• reference_frames -> reference_frames

• minimax_prompt -> prompt

• length -> length

• Qwen H3 encoder -> clip

• H3 video VAE -> vae

The reference is converted to 24 fps and trimmed to the format expected by H3.

Original audio is not forwarded.

Interpolation

Smooth

Smoothed camera motion. With extended contracts, movement stays more continuous between waypoints.

Linear

Straight interpolation between keyframes.

Timing

Video timing uses the timestamp of the last visible frame:

(length - 1) / fps

Redistribute Timing adjusts keyframe timing for more even average camera speed.

Loop Closure

loop_closure = auto can anchor the last frame to the first when the path is compatible.

Usually ON when:

• Freeze Frame is active.

• scene coverage | camera path is used.

• Orbit is exactly +360° or -360°.

• Final elevation matches the start.

• Final distance matches the start.

• A reference image is connected.

OFF when:

• Orbit is 359°.

• Orbit is 720°.

• Motion Frame is used.

• A still-image angle task is used.

• Final elevation or distance is different.

• loop_closure = off.

Close Orbit adjusts the final pose so the path closes correctly.

Main controls

• ui_language - interface language.

• camera_trajectory - time, azimuth, elevation, and distance keyframes.

• instruction - extra prompt instruction.

• subject_box - identifies the subject and orbit target in the first frame.

• orbit_direction - corrects the direction sent to H3.

• elevation_range - vertical control range.

• subject_framing - records close-up, medium, or wide framing.

• minimax_format - controls minimax_prompt formatting.

• prompt_detail - baseline or extended contracts.

• runtime_task - video camera path or new still-image angle.

subject_framing does not apply zoom or cropping.

Outputs

• compiled_prompt - prompt for H3 Edit.

• options - H3 Edit options.

• minimax_prompt - alternative prompt for native H3.

• storyboard_json - camera-path data.

• info - diagnostics.

• length - frame count.

• fps - output FPS.

• h3world_actions - approximate pan / tilt action text.

Limitations

• H3 can still miss angle, scale, or timing.

• The preview does not simulate the generated result.

• Empty subject_box uses the image center as reference target.

• Motion Frame depends on Ref2VA preserving the source action.

• h3world_actions describes approximate pan / tilt behavior, not a true geometric orbit.

Credits

Node by Bruxos do VFX.

Based on the H3 Edit integration from:

https://github.com/ethanfel/ComfyUI-MiniMax-H3-Edit

Repository:

https://github.com/NyckM/3d-Camera-control-H3-Minimax