ComfyUI Node: ADMD_AdditionalModelSelect

ADMD_AdditionalModelSelect:

The ADMD_AdditionalModelSelect node is designed to facilitate the selection of additional models for use in the AD MotionDirector pipeline. This node allows you to specify a motion module and optionally include an adapter LoRA (Low-Rank Adaptation) model. By providing these models, the node ensures that the necessary components are available for advanced motion generation tasks. The primary goal of this node is to streamline the process of integrating various models, making it easier to enhance the capabilities of your motion generation projects.

ADMD_AdditionalModelSelect Input Parameters:

motion_module

The motion_module parameter specifies the motion model to be used. This model is essential for generating motion in your project. The parameter expects a filename from the list of available animatediff_models. Selecting the correct motion module is crucial as it directly impacts the quality and type of motion generated.

use_adapter_lora

The use_adapter_lora parameter is a boolean flag that determines whether an adapter LoRA model should be used. When set to True, the node will include the specified adapter LoRA model in the process. This can enhance the motion generation by providing additional adaptation capabilities. The default value is True.

optional_adapter_lora

The optional_adapter_lora parameter is used to specify the filename of the adapter LoRA model if use_adapter_lora is set to True. This parameter is optional and expects a filename from the list of available loras. Including an adapter LoRA can improve the adaptability and performance of the motion generation process.

ADMD_AdditionalModelSelect Output Parameters:

additional_models

The additional_models output parameter is a list containing the paths to the selected motion model and, if applicable, the adapter LoRA model. This output is crucial as it provides the necessary models for the subsequent stages of the AD MotionDirector pipeline, ensuring that the motion generation process has all the required components.

ADMD_AdditionalModelSelect Usage Tips:

• Ensure that the motion_module parameter is set to a valid and existing motion model filename to avoid errors.
• If you do not need an adapter LoRA model, set the use_adapter_lora parameter to False to simplify the process.
• When using an adapter LoRA model, double-check that the optional_adapter_lora parameter points to a valid and existing filename to prevent issues during execution.

ADMD_AdditionalModelSelect Common Errors and Solutions:

Motion model <motion_model> does not exist

• Explanation: This error occurs when the specified motion model file does not exist in the animatediff_models directory.
• Solution: Verify that the motion_module parameter is set to a valid filename from the list of available animatediff_models.

Adapter LoRA path <adapter_lora_path> does not exist

• Explanation: This error occurs when the specified adapter LoRA file does not exist in the loras directory.
• Solution: Ensure that the optional_adapter_lora parameter is set to a valid filename from the list of available loras and that use_adapter_lora is set to True.