ComfyUI Node: MiniMax H3 Prompt Builder

MiniMax H3 Prompt Builder:

The MiniMaxH3PromptBuilder is a sophisticated node designed to facilitate the creation of guided prompts for the MiniMax H3 model, which is part of the FL2VA family, including T2VA, I2VA, FL2VA, L2VA, and the Ref2VA full-reference mode. This node is particularly beneficial for users looking to generate video content from text prompts, as it outputs a final prompt string along with optional pass-throughs for each reference slot. This functionality allows the builder to seamlessly integrate between media loaders and the MiniMaxH3ReferenceToVideo node, ensuring that the order of tags remains consistent with the wiring order. By doing so, it provides a streamlined workflow for artists and creators, enabling them to maintain control over the media elements used in their projects.

MiniMax H3 Prompt Builder Input Parameters:

prompt_text

The prompt_text parameter is the core input for the MiniMaxH3PromptBuilder, where you provide the textual description or command that you want to convert into a video using the MiniMax H3 model. This input directly influences the content and style of the generated video, as it serves as the primary directive for the model's output. There are no specific minimum or maximum values for this parameter, but the clarity and detail of the text can significantly impact the quality and relevance of the resulting video.

builder_state

The builder_state parameter holds the current configuration or mode of the builder, which determines how the node processes the input media. It is crucial for ensuring that the node operates in the correct mode, such as T2VA, I2VA, FL2VA, L2VA, or REF, each with its own media consumption capabilities. This parameter should be a valid JSON string representing the desired mode, and it is essential to keep it updated to prevent mismatches between the expected and actual media inputs.

references

The references parameter is an optional input that allows you to provide additional media elements, such as images, videos, or audio, that can be used as references in the prompt-building process. These references can enhance the context and specificity of the generated video, especially when using the REF mode, which supports multiple media types. The parameter accepts a bundle of media items, and its presence can influence the richness and accuracy of the final output.

prompt

The prompt parameter is an optional input that can be used to pass an existing prompt string into the builder. This allows for the modification or extension of pre-existing prompts, providing flexibility in how prompts are constructed and refined over time. It is particularly useful for iterative workflows where prompts are continuously adjusted based on previous outputs.

unique_id

The unique_id parameter is an optional identifier that can be used to track and manage different instances of the prompt-building process. This can be helpful in complex projects where multiple prompts are being generated simultaneously, as it allows for easy differentiation and organization of outputs.

MiniMax H3 Prompt Builder Output Parameters:

prompt

The prompt output is the final constructed string that encapsulates the instructions for the MiniMax H3 model to generate a video. This string is the culmination of the input parameters and any reference media, and it serves as the directive for the model's video generation process. The quality and specificity of this output directly affect the relevance and creativity of the resulting video.

IMAGE

The IMAGE outputs correspond to the images that are passed through from the input references or generated as part of the prompt-building process. These images can be used as visual references or components in the final video, and their presence can enhance the visual richness and context of the output.

AUDIO

The AUDIO outputs are audio elements that are either passed through from the input references or generated during the prompt-building process. These audio components can be used to add soundscapes or auditory context to the final video, enriching the overall sensory experience.

MiniMax H3 Prompt Builder Usage Tips:

• Ensure that the builder_state is always up-to-date with the current mode to prevent mismatches between expected and actual media inputs.
• Use clear and detailed prompt_text to improve the quality and relevance of the generated video.
• Leverage the references parameter to provide additional context and specificity, especially when using the REF mode.
• Regularly save and update your prompts to avoid issues with stale builder states.

MiniMax H3 Prompt Builder Common Errors and Solutions:

"connected while builder_state says {mode}; passing through unchanged"

• Explanation: This error occurs when there is a mismatch between the connected media inputs and the current mode specified in the builder_state.
• Solution: Ensure that the builder_state accurately reflects the mode you intend to use and that the connected media inputs are compatible with this mode.

"NO media on any output — check the loader lines above"

• Explanation: This message indicates that no media was detected on any output, which could be due to incorrect connections or missing inputs.
• Solution: Verify that all necessary media inputs are correctly connected and that the references parameter, if used, contains valid media items.