Metadata-Version: 2.1
Name: minimax-h3
Version: 1.0.1
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: Documentation, https://miniultra.tech/#generator
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

# 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)
- **Documentation & Showcase**: [https://miniultra.tech](https://miniultra.tech)

---

## 📄 License

MIT © [MiniMax H3](https://miniultra.tech)


