MiniMax Hailuo 2.3 API
MiniMax Hailuo 2.3 is MiniMax's video model released on October 28, 2025, with better body movement, facial expressions and stylized looks than Hailuo 02. On APIMart it runs with model ID MiniMax-Hailuo-2.3 for text to video and first-frame image to video.
Service Highlights
- Official Discounts
- Pay-as-you-go
- Fast & Low Latency
Video link valid for 72 hours
MiniMax Hailuo 2.3 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-2.3 | 768P | 0.488Credits(~$0.0488)/sec | 0.4636Credits(~$0.0464)/sec | 0.4392Credits(~$0.0439)/sec | 0.61Credits(~$0.061)/sec | 20% |
| 1080P | 0.72Credits(~$0.072)/sec | 0.684Credits(~$0.0684)/sec | 0.648Credits(~$0.0648)/sec | 0.9Credits(~$0.09)/sec | 20% |
* Actual costs are subject to final output.
MiniMax Hailuo 2.3 API: Text and Image to Video with Camera Commands
Generate 6 or 10 second videos at 768p or 1080p with MiniMax Hailuo 2.3 on APIMart. Start from a prompt or a first-frame image, and steer the shot with 15 camera movement commands written right in the prompt.
50K+
Active Users
99.9%
Uptime
2x
Faster
—
Cost Savings
MiniMax Hailuo 2.3 API Example: Text to Video and Image to Video
Call MiniMax Hailuo 2.3 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 2.3 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 2.3 task
POST /v1/videos/generations with model MiniMax-Hailuo-2.3, your prompt, duration and resolution. Add first_frame_image for image to video. The task ID is in data[0].task_id.
- 3
Get the Hailuo 2.3 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 2.3 API reference for every parameter, camera command 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-2.3",
"prompt": "[推进]A barista pours latte art in a sunlit cafe, steam rising, warm cinematic light",
"duration": 6,
"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-2.3",
"prompt": "[推进]A barista pours latte art in a sunlit cafe, steam rising, warm cinematic light",
"duration": 6,
"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-2.3",
"prompt": "[拉远]The scene slowly comes to life, gentle wind moves the hair and clothes",
"first_frame_image": "https://example.com/first-frame.jpg",
"duration": 6,
"resolution": "1080p"
}'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 2.3 API Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | Required | Default: MiniMax-Hailuo-2.3 | Use MiniMax-Hailuo-2.3. |
prompt | string | Required | Default: — | Scene, action and style, up to 2,000 characters. Supports camera commands such as [推进]. |
duration | integer | Optional | Default: 6 | 6 or 10 seconds. 1080p supports 6 seconds only. Send a number. |
resolution | string | Optional | Default: 768p | 768p or 1080p. |
first_frame_image | string | Optional | Default: — | First 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. |
