Skip to content
Projects

Anil-matcha/MiniMax-H3-API has 57 GitHub stars and 12 forks. GitHot measured 0 stars in 24 hours and +1 in 7 days. Last checked 2026-11-15 22:42 UTC. Last push 2026-10-01.

How these counts are measured

What you can do

  • Text-to-video generation
  • Image-to-video animation
  • Reference-to-video generation with multimodal inputs
  • First-and-last-frame guidance through image-to-video

Measured star growth

in 24h
0
in 7 days
+1
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Python SDK for the MiniMax H3 API — text-to-video, image-to-video, and first/last-frame video generation via Muapi.

AI

README.md

Original

MiniMax H3 API: Python SDK for AI Video Generation

Powered by MuAPI License: MIT Python 3.9+

Python SDK for the MiniMax H3 API on Muapi. Generate video from text, animate a still image, or guide a new video with image, video, and optional audio references using one API key.

▶ Watch: How to Access MiniMax Hailuo H3 API (Step-by-Step Guide): Native 2K Video Generation with Sound

Related Projects

Features

  • Text-to-video generation
  • Image-to-video animation
  • Reference-to-video generation with multimodal inputs
  • First-and-last-frame guidance through image-to-video
  • Submit, poll, and webhook-ready asynchronous workflow
  • Simple Python client built on requests

Installation

pip install minimax-h3-api

Or install from source:

git clone https://github.com/Anil-matcha/MiniMax-H3-API.git
cd MiniMax-H3-API
pip install -e .

Set your Muapi API key:

export MUAPI_API_KEY=your_muapi_api_key

Quick start

from minimax_h3_api import MiniMaxH3API

api = MiniMaxH3API()

task = api.text_to_video(
    "A cinematic tracking shot of a silver sports car driving through a rain-soaked city at night",
    aspect_ratio="16:9",
    resolution="2k",
    duration=5,
)

result = api.wait_for_completion(task["request_id"])
print(result["outputs"][0])

Workflows

Text to video

task = api.text_to_video(
    prompt="A lone astronaut walking through a field of bioluminescent flowers, slow camera dolly in"
)

Image to video

task = api.image_to_video(
    prompt="The camera slowly pushes in as a warm breeze moves through the subject's hair",
    image_url="https://example.com/source-image.jpg",
    last_image_url="https://example.com/final-frame.jpg",
    duration=5,
)

Reference to video

task = api.reference_to_video(
    prompt="Use the references to create a cinematic product reveal with a slow camera orbit",
    reference_images=["https://example.com/product.jpg"],
    reference_videos=["https://example.com/motion-reference.mp4"],
    reference_audios=["https://example.com/soundtrack.mp3"],
    aspect_ratio="16:9",
    resolution="2k",
    duration=5,
)

At least one reference_images or reference_videos URL is required. Audio references are optional and cannot be used alone.

First and last frame compatibility alias

Existing integrations can continue using first_last_frame(). It now maps to the current image-to-video endpoint with image_url and last_image_url; new code should call image_to_video() directly.

API endpoints

Workflow Endpoint
Text to Video POST /api/v1/minimax-h3-text-to-video
Image to Video POST /api/v1/minimax-h3-image-to-video
Reference to Video POST /api/v1/minimax-h3-reference-to-video
Poll task GET /api/v1/predictions/{request_id}/result

See the full MiniMax H3 API guide and Muapi documentation.

License

MIT