Metadata-Version: 2.1
Name: minimax-h3
Version: 1.0.0
Summary: Official Python SDK for MiniMax H3 multimodal AI video generator with native stereo audio and 2K cinematic rendering.
Home-page: https://miniultra.tech
Author: MiniMax H3
Author-email: support@miniultra.tech
License: UNKNOWN
Project-URL: Homepage, https://miniultra.tech
Project-URL: Interactive Studio, https://miniultra.tech/#generator
Project-URL: Repository, https://github.com/lidong-tools/website-miniultra-tech
Project-URL: Bug Tracker, https://github.com/lidong-tools/website-miniultra-tech/issues
Description: # MiniMax H3 Python SDK
        
        [![PyPI version](https://img.shields.io/pypi/v/minimax-h3.svg)](https://pypi.org/project/minimax-h3/)
        [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
        [![Python Versions](https://img.shields.io/pypi/pyversions/minimax-h3.svg)](https://pypi.org/project/minimax-h3/)
        [![Official Website](https://img.shields.io/badge/Official%20Studio-miniultra.tech-blue)](https://miniultra.tech)
        
        Official Python SDK for **[MiniMax H3](https://miniultra.tech)** — creating up to 15-second 2K cinematic AI videos with native stereo audio from multimodal references.
        
        > 🎬 **Online Studio & Generator**: Experience the web generator directly at **[https://miniultra.tech](https://miniultra.tech)**.
        
        ---
        
        ## ✨ Features
        
        - **2K Native Video Generation**: High-resolution 2K video output up to 15 continuous seconds.
        - **Synchronized Stereo Audio**: Dual-channel sound design, ambient Foley, and dialogue generated together.
        - **Multimodal Prompts**: Combine text instructions with image and video references.
        - **Zero Dependencies**: Lightweight SDK using only Python standard libraries.
        - **Type Hinting**: Complete typing for seamless IDE integration.
        
        ---
        
        ## 📦 Installation
        
        ```bash
        pip install minimax-h3
        ```
        
        ---
        
        ## 🚀 Quick Start
        
        ### 1. Generate 2K Video with Stereo Audio
        
        ```python
        from minimax_h3 import MiniMaxH3Client
        
        client = MiniMaxH3Client()
        
        task = client.generate_video(
            prompt="Cinematic neon-lit samurai duel in a rainy alleyway, water splashing, stereo ambient thunder, 2K resolution",
            aspect_ratio="16:9",
            resolution="2k",
            duration=15,
            enable_stereo_audio=True,
        )
        
        print(f"Task submitted! ID: {task.get('taskId')}")
        ```
        
        ### 2. Check Task Progress
        
        ```python
        task_status = client.get_task(task_id="YOUR_TASK_ID")
        print("Status:", task_status.get("status"))
        if task_status.get("videoUrl"):
            print("Download URL:", task_status.get("videoUrl"))
        ```
        
        ---
        
        ## 🔗 Official Links & Resources
        
        - **Official Web Platform**: [https://miniultra.tech](https://miniultra.tech)
        - **Interactive Generator**: [https://miniultra.tech/#generator](https://miniultra.tech/#generator)
        - **Repository**: [https://github.com/lidong-tools/website-miniultra-tech](https://github.com/lidong-tools/website-miniultra-tech)
        
        ---
        
        ## 📄 License
        
        MIT © [MiniMax H3](https://miniultra.tech)
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Multimedia :: Video
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown
