MiniMax Hailuo 02 API (MiniMax-Hailuo-02)
per generated second, billed by resolution — one OpenAI-compatible endpoint at
https://api.apimart.ai/v1, no monthly plan required. (observed 2026-10-12)
Get an API key · Live pricing · Model page · ⚡ 60-second quickstart
Why teams call MiniMax Hailuo 02 (MiniMax-Hailuo-02) through APIMart
- One key, entire catalog. The same
https://api.apimart.ai/v1base URL andAuthorizationheader reach MiniMax Hailuo 02 (MiniMax-Hailuo-02) and 300+ other image, video and language models — switch themodelfield, not your client. - Per-second billing. A job is charged for the seconds it actually generates at the resolution you picked.
- The charge comes back in the response. Every completed task reports the amount billed (
cost/credits_cost); a task markedfailedis refunded. - Async by design. Submit, take the
task_id, pollGET /v1/tasks/{id}— batching and retries are ordinary queue work, not a bespoke integration.
MiniMax Hailuo 02 does text-to-video and image-to-video with consistent motion and high visual quality.
Model id and routes
| Route | model value |
Billing | Notes |
|---|---|---|---|
| Text-to-video / image-to-video | MiniMax-Hailuo-02 |
per generated second, by resolution | see the model page for the exact tiers |
Endpoint: POST https://api.apimart.ai/v1/videos/generations (OpenAI-compatible), then poll GET /v1/tasks/{task_id}.
Pricing
| Output | List price | Effective price |
|---|---|---|
| default | $0.0375 | $0.03 |
| 4K | $0.05 | $0.04 |
The token-billed official route bills per million tokens instead: text_input $1.60, cached_text_input free, image_input $1.60, cached_image_input free, text_output $9.60, image_output $96.00.
Prices are a snapshot; the pricing page and data/model.json are refreshed by CI, and a completed task reports the exact amount in its cost field.
Request parameters
| Field | Type | Default | Notes |
|---|---|---|---|
model |
string | required | the model id shown in the route table above |
prompt |
string | required | the shot description; camera and subject motion belong here |
duration |
integer | route default | clip length in seconds — billing is per generated second |
resolution |
string | route default | 480P / 720P / 1080P or the route’s own tiers |
size / aspect_ratio |
string | 16:9 |
output framing |
image_urls |
string[] | — | first frame, first + last frame, or style references, where supported |
seed |
integer | — | fix the seed to reproduce a take |
The table lists the fields accepted by the APIMart OpenAI-compatible video endpoint. Check the model page for anything this model adds on top.
Quickstart
curl --request POST --url https://api.apimart.ai/v1/videos/generations \ --header "Authorization: Bearer $APIMART_API_KEY" --header 'Content-Type: application/json' \ -d '{"model":"MiniMax-Hailuo-02","prompt":"A bamboo forest at sunrise, slow push-in","duration":5,"resolution":"720P","size":"16:9"}'
import os, time, requests BASE = "https://api.apimart.ai/v1" HEADERS = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}", "Content-Type": "application/json"} created = requests.post(f"{BASE}/videos/generations", headers=HEADERS, timeout=60, json={ "model": "MiniMax-Hailuo-02", "prompt": "A bamboo forest at sunrise, slow push-in", }).json() task_id = created["data"]["id"] while True: task = requests.get(f"{BASE}/tasks/{task_id}", headers=HEADERS, timeout=60).json()["data"] if task["status"] in ("completed", "failed"): break time.sleep(5) print(task.get("cost"), task["result"]["videos"][0]["url"])
Runnable versions: examples/. The task lifecycle is pending → processing → completed | failed.
FAQ
What is the MiniMax Hailuo 02 model id?
MiniMax-Hailuo-02. See the route table above.
How is it billed?
per generated second, billed by resolution. The completed task reports the exact amount in its cost field; a failed task is refunded.
How do I get a key?
Use the Get an API key link — $1 minimum top-up, no plan required.
Attributed links (how this repository is measured)
| Purpose | Attributed link | Target |
|---|---|---|
| Model page | https://go.apimart.ai/k-bca8b4 | apimart.ai/ja/model/minimax-hailuo-02 |
| Live pricing | https://go.apimart.ai/k-6c9607 | apimart.ai/ja/pricing |
| Get an API key | https://go.apimart.ai/k-fdb411 | apimart.ai/ja/keys |
Outbound APIMart links are minted through the promo link API; hand-made tracking parameters are rejected by
tools/check_links.py in CI.
Disclosure
MiniMax Hailuo 02 is a third-party model served through APIMart; this repository documents how to call it and publishes model ids and prices, and does not claim official status. Model names, prices and documentation belong to their respective owners.
License
MIT — see LICENSE.