HiggsfieldMotionTransferNode - ComfyUI Built-in Node Documentation

The Higgsfield Genjutsu Motion Transfer node recasts a video with new characters, locations or styles taken from reference images while keeping the motion, camera movement, timing and audio of the source clip. Connect the clip to restyle and one or more reference images that describe the new look, then describe the result in the prompt. The request is sent to the Higgsfield API and the generated video is returned.

Inputs

Parameter	Description	Data Type	Required	Range
`model`	Model to use. Selecting a model reveals the parameters specific to it: `video`, `reference_images`, `prompt`, `resolution`, and `seed`.	DYNAMIC_COMBO	Yes	`"genjutsu-v1.0"`
`video`	Source video whose motion, camera movement, timing and audio are kept. At least 4 seconds; only the first 30 seconds are used.	VIDEO	Yes	4 to 30 seconds
`reference_images`	Growable slot: connect 1 to 8 images (`image_1`, `image_2`, …) of the characters, locations or styles to use. A batched input counts once per image.	IMAGE	Yes	1 to 8 images
`prompt`	Optional. Describe the result, for example which reference replaces which person, or a new setting. (default: empty)	STRING	Yes	Any text
`resolution`	Resolution of the output video. (default: `"720p"`)	COMBO	Yes	`"480p"` `"720p"` `"1080p"`
`seed`	Seed controls whether the node should re-run; results are non-deterministic regardless of seed. This parameter has “control after generate” functionality (default: 42).	INT	Yes	0 to 2147483647

The source video is validated before the request is sent: a clip shorter than 4 seconds is rejected, and a clip longer than 30 seconds is trimmed to its first 30 seconds. Its audio is carried over to the result. Reference images are uploaded first, and the total number of images across all connected slots cannot exceed 8, even though the node exposes eight slots. Higgsfield’s content moderation can reject the input or the result, which raises an error instead of returning a video.

Outputs

Output Name	Description	Data Type
`VIDEO`	The restyled video file.	VIDEO

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): f0c30fb93dd2af8d564335290fdb6ff61c38e36ab62cef9641fd1aa81cc10cd2

​Inputs

​Outputs

Inputs

Outputs