MiniMax Hailuo 02 API
MiniMax Hailuo 02 (Hailuo 2) is MiniMax's video model released on June 18, 2025, built for strong instruction following and realistic physics. On APIMart it runs as the Hailuo API with model ID MiniMax-Hailuo-02, supporting text to video and first-and-last-frame image to video.
Service Highlights
- Official Discounts
- Pay-as-you-go
- Fast & Low Latency
Video link valid for 72 hours
MiniMax Hailuo 02 API Pricing
Transparent pricing with no hidden fees. Pay only for what you use.
| Variant | Tier | GoldCurrent price | Platinum | Diamond | Official | Your savings |
|---|---|---|---|---|---|---|
MiniMax-Hailuo-02 | 512P | 0.104Credits(~$0.0104)/sec | 0.0988Credits(~$0.0099)/sec | 0.0936Credits(~$0.0094)/sec | 0.13Credits(~$0.013)/sec | 20% |
| 768P | 0.4Credits(~$0.04)/sec | 0.38Credits(~$0.038)/sec | 0.36Credits(~$0.036)/sec | 0.5Credits(~$0.05)/sec | 20% | |
| 1080P | 0.8Credits(~$0.08)/sec | 0.76Credits(~$0.076)/sec | 0.72Credits(~$0.072)/sec | 1Credits(~$0.1)/sec | 20% |
* Actual costs are subject to final output.
MiniMax Hailuo 02 API: Text to Video and First-and-Last-Frame Video
Call MiniMax Hailuo 02 through the Hailuo API on APIMart. Turn a prompt into a 5 or 10 second clip, or guide the motion with a first frame and an optional last frame, at 512p, 768p or 1080p. One API key, pay per second.
50K+
Active Users
99.9%
Uptime
2x
Faster
—
Cost Savings
MiniMax Hailuo 02 API Example: Text to Video and Image to Video
Call the Hailuo API on APIMart with one POST request. Generation is asynchronous: submit a task, then poll the task endpoint to get the video URL.
- 1
Authenticate Hailuo API requests
Save your APIMart key in the APIMART_API_KEY environment variable and send it as Authorization: Bearer <key> on every request.
- 2
Submit a Hailuo 02 task
POST /v1/videos/generations with model MiniMax-Hailuo-02, your prompt, duration and resolution. Add first_frame_image and last_frame_image for image to video. The task ID is in data[0].task_id.
- 3
Get the Hailuo 02 video
Poll GET /v1/tasks/{task_id} until status is completed, then read the video URL from data.result.videos[0].url[0]. Results are kept for 72 hours, so download them in time.
See the MiniMax Hailuo 02 API reference for every parameter and response field.
curl -X POST https://api.apimart.ai/v1/videos/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-Hailuo-02",
"prompt": "A gymnast performs a backflip on a balance beam in an empty arena, slow motion, dramatic side lighting",
"duration": 10,
"resolution": "768p",
"prompt_optimizer": true
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "MiniMax-Hailuo-02",
"prompt": "A gymnast performs a backflip on a balance beam in an empty arena, slow motion, dramatic side lighting",
"duration": 10,
"resolution": "768p",
"prompt_optimizer": True
}
resp = requests.post(f"{API_BASE}/v1/videos/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["videos"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(10)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/videos/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-Hailuo-02",
"prompt": "Smooth camera move from the first frame to the last frame, natural motion",
"first_frame_image": "https://example.com/start.jpg",
"last_frame_image": "https://example.com/end.jpg",
"duration": 5,
"resolution": "768p"
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"MiniMax Hailuo 02 API Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | Required | Default: MiniMax-Hailuo-02 | Use MiniMax-Hailuo-02. |
prompt | string | Required | Default: — | Describe the scene, action and style in detail. |
duration | integer | Optional | Default: 5 | 5 or 10 seconds. 1080p supports 5 seconds only. Send a number. |
resolution | string | Optional | Default: 768p | 512p, 768p or 1080p. |
first_frame_image | string | Optional | Default: — | First frame as a public URL or a Base64 data URI. |
last_frame_image | string | Optional | Default: — | Last frame as a public URL or a Base64 data URI. |
prompt_optimizer | boolean | Optional | Default: true | Automatically optimize the prompt. |
fast_pretreatment | boolean | Optional | Default: false | Shorten the prompt optimization step for faster processing. |
watermark | boolean | Optional | Default: false | Add a watermark to the output. |
nsfw_check | boolean | Optional | Default: false | Review the prompt and input images with omni-moderation-latest before submission. |
