ComfyUI Extension: ComfyUI-MiniMax-H3-Promptor

ComfyUI-MiniMax-H3-Promptor Introduction

The ComfyUI-MiniMax-H3-Promptor is an innovative extension designed to enhance your creative workflow by generating high-quality, cinema-production-grade prompts. These prompts are specifically formatted for the MiniMax H3 Video Generation System, making it an essential tool for AI artists looking to create visually compelling video content. The extension offers a robust, node-based automation suite that separates multimodal visual analysis from text-based prompt structuring. This separation allows for extreme customizability, precise scene descriptions, and reduced API operating costs, making it a powerful tool for artists who want to focus on creativity without getting bogged down by technical complexities.

How ComfyUI-MiniMax-H3-Promptor Works

At its core, the ComfyUI-MiniMax-H3-Promptor operates through a decoupled architecture consisting of two main nodes: the H3_Vision_Analyzer and the H3_Promptor. These nodes work together to handle complex tasks without duplicating the costs associated with large language model (LLM) vision processing.

• H3_Vision_Analyzer: Think of this node as your virtual Director of Photography. It analyzes input images and videos using configurable presets, allowing you to focus on specific elements like characters, lighting, or the entire composition. This analysis is then converted into a structured text-based context that feeds into the next node.
• H3_Promptor: This node takes the structured text from the Vision Analyzer and your creative descriptions to format the final H3 Prompt. It operates quickly because it doesn't need to re-analyze images, making it efficient and effective for generating prompts.

ComfyUI-MiniMax-H3-Promptor Features

The extension is packed with features designed to give you control and flexibility:

• Multimodal Analysis: Analyze up to four images and a batch of video keyframes simultaneously, using JSON-backed presets that you can customize.
• Customizable Analysis Strategies: Easily add new analysis strategies by editing the vision_prompts.json file, which updates automatically upon restart.
• Multilingual Output: Choose between English and Chinese for your analysis output, making it accessible for international projects.
• Intelligent Cross-Node Detection: Automatically detects the appropriate generation mode based on your inputs, whether it's text-to-video, image-to-video, or video-to-video.
• Language and Duration Syncing: Output prompts in your preferred language and sync video duration to match your creative vision.

ComfyUI-MiniMax-H3-Promptor Models

The extension supports various models through different providers, allowing you to choose the best fit for your project:

• OpenAI: Uses the gpt-4o model, ideal for projects requiring advanced language capabilities.
• Ollama: Employs the llama3.1 model, suitable for local processing without external API calls.
• Gemini: Utilizes the gemini-2.5-flash model, offering fast and efficient content generation.
• Claude: Features the claude-sonnet-4-20250514 model, known for its creative writing capabilities.

Troubleshooting ComfyUI-MiniMax-H3-Promptor

If you encounter issues while using the extension, here are some common problems and solutions:

• Problem: The Vision Analyzer isn't updating with new analysis strategies.
• Solution: Ensure you've edited the vision_prompts.json file correctly and restart ComfyUI to apply changes.
• Problem: The output language isn't changing.
• Solution: Double-check the language settings in both nodes and ensure they match your desired output.
• Problem: API keys aren't working.
• Solution: Verify that your API keys are correctly entered in the config.json file or directly in the node's UI.

Learn More about ComfyUI-MiniMax-H3-Promptor

To further enhance your understanding and use of the ComfyUI-MiniMax-H3-Promptor, consider exploring the following resources:

• Tutorials and Documentation: Look for online tutorials that provide step-by-step guides on using the extension effectively.
• Community Forums: Join forums and communities where you can ask questions, share experiences, and get support from other AI artists.
• GitHub Repository: Visit the GitHub repository for the latest updates and additional documentation. By leveraging these resources, you can maximize the potential of the ComfyUI-MiniMax-H3-Promptor and elevate your creative projects to new heights.