ComfyUI Node: HY-Motion Text Encoder Loader

HY-Motion Text Encoder Loader:

The HYMotionTextEncoderLoader is a specialized node designed to facilitate the loading and utilization of dual text encoders within the HY-Motion framework. This node is integral for processing natural language descriptions into motion-related embeddings, leveraging the capabilities of both CLIP and Qwen3 text encoders. By combining these two powerful models, the node enhances the ability to interpret and encode complex textual descriptions into meaningful motion representations. This dual encoding approach allows for a more nuanced understanding of text, capturing both visual and contextual elements, which is particularly beneficial for applications in AI-driven motion generation and animation. The primary goal of the HYMotionTextEncoderLoader is to streamline the process of text encoding, ensuring that users can easily convert descriptive language into actionable data for motion synthesis.

HY-Motion Text Encoder Loader Input Parameters:

text_encoder

The text_encoder parameter is a critical input that specifies the dual text encoder to be used, which combines the strengths of CLIP and Qwen3 models. This parameter is essential for the node's operation as it determines the encoding mechanism that will process the input text. The dual encoder setup allows for a comprehensive analysis of the text, capturing both visual and semantic nuances. There are no specific minimum or maximum values for this parameter, as it is a categorical selection of the encoder type. The default setting is the dual encoder provided by the HYMotionTextEncoderLoader, which is optimized for motion-related text encoding tasks.

text

The text parameter is a string input that represents the natural language description of the desired motion. This parameter is pivotal as it directly influences the quality and relevance of the generated motion embeddings. Users are encouraged to provide detailed and descriptive text to achieve the best results. The text parameter supports multiline input, allowing for complex and nuanced descriptions. The default value is "A person is walking forward.", which serves as a basic example of a motion description. There are no explicit minimum or maximum length constraints, but overly lengthy inputs may be truncated for processing efficiency.

HY-Motion Text Encoder Loader Output Parameters:

text_embeds

The text_embeds output parameter represents the encoded embeddings generated from the input text using the specified dual text encoder. These embeddings are crucial as they encapsulate the semantic and visual information extracted from the text, which can then be used for various motion synthesis tasks. The text_embeds output is a structured data object that includes visual text embeddings, contextual text embeddings, and the length of the contextual text. This output is essential for downstream processes that require a detailed and accurate representation of the input text in a format suitable for motion generation.

HY-Motion Text Encoder Loader Usage Tips:

• Ensure that the input text is as descriptive and detailed as possible to maximize the quality of the generated motion embeddings. This will help the dual encoder capture the full context and nuances of the desired motion.
• Familiarize yourself with the capabilities of the CLIP and Qwen3 models to better understand how they contribute to the encoding process. This knowledge can help you tailor your input text to leverage the strengths of each model.

HY-Motion Text Encoder Loader Common Errors and Solutions:

Error: "Text encoder not found"

• Explanation: This error occurs when the specified text encoder is not available or improperly loaded.
• Solution: Verify that the HYMotionTextEncoderLoader is correctly set up and that the dual text encoder is properly installed and accessible.

Error: "Input text too long"

• Explanation: This error indicates that the input text exceeds the processing limits of the encoder.
• Solution: Shorten the input text or break it into smaller segments to ensure it fits within the encoder's processing capacity.

Error: "Encoding failed due to missing parameters"

• Explanation: This error suggests that one or more required input parameters are missing or incorrectly specified.
• Solution: Double-check that all required parameters, such as text_encoder and text, are provided and correctly configured before attempting to encode the text again.