A complete desktop GUI for MiniMax H3 — the multimodal video generation model from MiniMax.
Generate high-quality videos (up to 2K, 4–15 seconds) from text, images, reference media, and more. Built with CustomTkinter for a clean, modern interface.
- Text-to-Video
- Image-to-Video (first frame, last frame, or both)
- Reference-to-Video (up to 9 images + 3 videos + 3 audio clips)
- H3-Context-IR prompt enhancement (recommended for better results)
- Video Regeneration (768P → 2K)
- Duration control (4–15 seconds)
- Resolution:
768Por2K - Aspect ratios:
16:9,9:16,1:1,4:3,3:4,21:9,adaptive - Optional AIGC watermark
- Local file upload support (via MiniMax Files API)
- Task listing, status polling, and cancel/delete
- Live log and non-blocking generation (threaded)
- Python 3.9+
- A MiniMax API key (platform.minimax.io)
pip install customtkinter pillow requestsPowerShell:
[System.Environment]::SetEnvironmentVariable("MINIMAX_API_KEY", "your_actual_api_key_here", "User")Command Prompt:
setx MINIMAX_API_KEY "your_actual_api_key_here"Close and reopen your terminal after setting the key.
python h3_gui.py- Launch the GUI.
- Choose a generation mode:
- Text-to-Video
- Image-to-Video
- Reference-to-Video
- Enter your prompt.
- (Optional) Enable H3-Context-IR for better prompt understanding.
- Adjust duration, resolution, and aspect ratio.
- Add first/last frames or reference media if needed.
- Click Generate Video.
The app will poll the task status automatically and download the finished video when ready.
During my testing it took about 10 minutes to generate a 15 second text-to-video enhanced prompt video clip.
You can also:
- Regenerate previous 768P results to 2K
- View recent tasks
- Cancel or delete tasks
- MiniMax H3 is an asynchronous API. Generation can take from under a minute to several minutes depending on length and resolution.
- Public URLs are preferred for media. Local files are uploaded via the MiniMax Files API when possible.
- Always check your MiniMax account for credit usage and rate limits.
- This tool talks directly to the official MiniMax H3 API (
api.minimax.io).
Individual Use Only
This software is free for individuals to use.
You may:
- Use it for any personal purpose
- Generate videos and use those videos commercially (including selling or monetizing the videos you create)
You may not:
- Use this software on behalf of, or inside, any organization, company, business, or group
- Include this code (or substantial portions of it) in any other project, product, or service
- Redistribute this software or any modified version of it
- Sell this software or any derivative of the code itself
In short:
Individuals can freely use the tool and make money from the videos they generate.
Organizations and commercial redistribution/sale of the code are not allowed.
CustomTkinter is released under the MIT License.
This is an unofficial third-party tool. MiniMax H3 and the MiniMax API are properties of MiniMax.
Use of the API is subject to MiniMax’s own terms of service and pricing.
The author is not affiliated with MiniMax.