MiniMax H3 Video Generation Is Live

​

Key Takeaways

• One endpoint for every mode: text-to-video, first / last / first-and-last-frame video, and mixed reference generation with up to 9 images, 3 videos, and 3 audio clips all go through POST /hailuo/v2/video_generation
• Native stereo audio: every clip includes music and sound effects, and the picture can follow the rhythm of reference audio
• Self-hosted deployment of the open weights: 768P, any whole duration from 4 to 15 seconds, 7 aspect ratios
• Priced at $0.03 per second: a 10-second clip costs $0.30; reference images, videos, and audio are free; failed tasks are refunded in full automatically
• Works in the default group, and the svip group works too

​

Background

​

In Detail

​

Benchmarks

​

Key Features

​

Technical Specs

​

Putting It to Use

​

Recommended Use Cases

• Music visuals and dance clips: let reference audio drive the rhythm
• Short dramas with consistent characters: pin characters and props with several reference images
• Motion and camera transfer: copy camera moves from a reference video
• Animating products and posters: a first frame plus a camera description, with adaptive to keep the image’s ratio

​

Code Example

import time
import requests

API_KEY = "sk-your-apiyi-key"
BASE = "https://api.apiyi.com/hailuo/v2"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

task_id = requests.post(f"{BASE}/video_generation", headers=HEADERS, timeout=60, json={
    "model": "MiniMax-H3",
    "content": [{"type": "text", "text": "A lighthouse by the sea at dusk, slow dolly in, waves and low strings"}],
    "resolution": "768P",
    "duration": 10,        # integer 4–15, billed per second
    "ratio": "16:9",
}).json()["task_id"]

while True:
    task = requests.get(f"{BASE}/query/video_generation/{task_id}", headers=HEADERS, timeout=30).json()["task"]
    if task["status"] in ("succeeded", "failed"):
        break
    time.sleep(10)
print(task.get("content", {}).get("url") or task["error"])

​

Best Practices

1. Start the path with /hailuo; without it you get a web page instead of JSON
2. Test with 4–5 seconds first, then render the 10–15 second version once the composition works
3. Use a fixed ratio for text-only requests; adaptive only works with images or videos
4. Host media on stable public storage; hotlink protection or expired signatures make the task fail when downloading media (failures are refunded)
5. Store task.content.url right away, and check links with GET, because HEAD requests return 403

​

Pricing and Availability

​

Pricing

• Billed by the requested duration, pre-charged when the task is accepted; failed tasks are refunded in full automatically, and submission errors are not billed
• Groups: default or svip; we recommend the Pay-as-you-go Priority billing model for the Token

​

Top-up Bonuses

​

Summary