MiniMax released Hailuo 2.3 on October 28, 2025, as the successor to Hailuo 02, and the upgrade is squarely about motion. Where earlier models could stumble on complex human movement, dance, or subtle facial performance, Hailuo 2.3 is built to handle exactly that, with limbs that stay attached and move believably, more natural expressions, and steadier physics when the camera is moving. It is live on Apiframe now: one key, one request format, and the same billing and job limits you are already using for every other model on the platform.
This guide covers what is actually new, then walks through generating with it, including real pricing you can plan a budget around.
What's New in Hailuo 2.3
Much better human motion. Complex body movement and dance render more fluidly, and limbs stay where they should. This is the area where video models most often fail, producing extra arms that flicker in and out or joints that bend the wrong way during fast movement, and it is the problem Hailuo 2.3 was built to solve.
Expressive faces. Small smiles, blinks, and shifts in emotion come through naturally, which suits close-up storytelling and character scenes where a stiff face breaks the illusion.
Convincing physics and lighting. Light direction, shadows, and color hold steady under tricky lighting and moving cameras, and the shape of the scene stays put instead of quietly shifting between frames.
Wide range of styles. Beyond photorealism, Hailuo 2.3 handles anime, illustration, ink-wash painting, and game cinematics with stable, vivid output. It is not a realism-only model.
Camera control and consistency. On tracking shots and other moving-camera work, near and far objects shift at the right relative speeds, so subjects and backgrounds stay solid across the clip instead of warping.
Faces and logos stay recognizable. Faces, branded objects, and on-screen logos stay sharp through movement, which matters for product and branding work where a logo going blurry mid-clip is a real problem. If you are solving this across a whole series of assets, our guide on keeping AI-generated characters consistent covers the wider techniques.
Getting Started on Apiframe
Hailuo 2.3 runs through the same API key and billing as every other model on Apiframe, including Kling, Veo, and Seedance, so it is not a separate integration. It is one more model available through the unified API you may already have set up. Requests run in the background: submit a job, then either check back for the result or have it delivered to a webhook, which is an automatic callback to your server when the job finishes. No MiniMax account required.
If you are starting from scratch, sign up for free credits, grab an API key, and you will be generating within minutes. The full parameter reference lives in the Hailuo 2.3 docs, or you can try it in Apiframe Studio without writing any code first. Our getting started guide walks through account setup if this is your first time calling the API, and if you are still comparing options, we have also compared the main Hailuo API providers on price and features.
Full Code Walkthrough
1. Text-to-video
Start with a plain text prompt and a duration. Here it is in curl:
curl -X POST https://api.apiframe.ai/v2/videos/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "cinematic aerial shot of a medieval castle at dawn with mist rolling through the valleys",
"model": "hailuo-2.3",
"hailuoParams": {
"duration": 10,
"resolution": "768p"
}
}'The same call in Python:
import requests
response = requests.post(
"https://api.apiframe.ai/v2/videos/generate",
headers={
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
json={
"prompt": "cinematic aerial shot of a medieval castle at dawn with mist rolling through the valleys",
"model": "hailuo-2.3",
"hailuoParams": {
"duration": 10,
"resolution": "768p",
},
},
)
print(response.json()) # { "jobId": "...", "status": "QUEUED" }2. Image-to-video
Add an image URL to animate a still instead of generating from scratch. For a fuller walkthrough of this pattern, see our image-to-video API Python tutorial.
response = requests.post(
"https://api.apiframe.ai/v2/videos/generate",
headers={"X-API-Key": "afk_your_api_key_here"},
json={
"prompt": "a dancer performing a graceful spin, studio lighting",
"model": "hailuo-2.3",
"hailuoParams": {
"image": "https://example.com/dancer.jpg",
"duration": 6,
"resolution": "1080p",
"prompt_optimizer": True,
},
},
)Available hailuoParams fields: duration (6 or 10 seconds, default 6), resolution (768p or 1080p, default 768p), image (URL for image-to-video), and prompt_optimizer (lets Hailuo rewrite your prompt for better results). Two constraints to know before you build. First, 1080p does not support 10-second clips, so if you need the full 10 seconds, stay at 768p. Second, Hailuo 2.3 has no end-frame parameter, so if your clip has to finish on a specific image, you will need Hailuo 02 instead.
3. Poll for the result
The submission returns a jobId right away. Poll GET /v2/jobs/{id} until the status is COMPLETED, or supply a webhook_url instead so the result comes to you.
import time
while True:
job = requests.get(
f"https://api.apiframe.ai/v2/jobs/{job_id}",
headers={"X-API-Key": "afk_your_api_key_here"},
).json()
if job["status"] in ("COMPLETED", "FAILED"):
break
time.sleep(5)
print(job["result"]) # { "videoUrl": "https://cdn2.apiframe.ai/videos/..." }Average completion time is around 180 seconds. That is a long time to hold a request open, so webhooks are usually the better choice in production. Our walkthrough on setting up webhook callbacks for media generation covers the handler and retry handling.
Pricing
Hailuo 2.3 charges one flat credit price per generation, set by resolution and duration.
| Variant | Credits | Approx. USD |
|---|---|---|
| 768p, 6s | 41 | $0.41 |
| 768p, 10s | 81 | $0.81 |
| 1080p, 6s | 71 | $0.71 |
Your plan affects more than the price per generation. It also sets how many jobs you can run at the same time and how many credits you get each month. Apiframe's pricing page has the full breakdown, from the free tier up through Enterprise. For how this compares with other video models, see our AI video API pricing guide, and if you are budgeting for a real workload, our guide to estimating monthly AI video costs walks through the math.
A cheaper, faster sibling model, hailuo-2.3-fast, is also available for drafts and iteration. It runs the same pipeline at roughly a third less per clip (28 credits for 768p at 6 seconds, versus 41) and finishes in about half the time. Our Hailuo versions guide covers when to use which Hailuo model, including Hailuo 02.
Use Cases
Dance and movement content. Hailuo 2.3's motion handling makes it a solid fit for choreography, sports, and any clip with fast, complex body movement, which is exactly where weaker models tend to fall apart.
Character-driven storytelling. Because small facial movements read convincingly, close-up dialogue and reaction shots hold up, which is where subtle performance carries the scene.
Stylized content. Anime, illustration, and ink-wash styles come out stable and vivid, rather than the default photorealism most video models push you toward.
Product and branded content. Because faces and logos survive the movement, product names and packaging stay legible through camera moves. Pair it with Kling 3.0 if you want to compare cinematic styles on the same project, and see our comparison of the best AI video APIs for mobile ad creatives if ads are your main output.
FAQ
What is Hailuo 2.3?
MiniMax's video generation model, released October 28, 2025, as the successor to Hailuo 02. It focuses on realistic human motion, facial expression, and physics.
What's different between Hailuo 2.3 and Hailuo 02?
Hailuo 2.3 improves motion, facial expression, physics, and style range over Hailuo 02. The trade-off is that it drops end-frame control, which Hailuo 02 still supports. Full comparison in our Hailuo versions guide.
Does Hailuo 2.3 support image-to-video?
Yes, through the image parameter. Text-to-video and image-to-video both use the same request format and model ID.
What resolutions and durations does it support?
768p or 1080p, and 6 or 10-second clips, with one constraint: 1080p does not support the 10-second duration.
How much does the Hailuo 2.3 API cost?
41 credits ($0.41) for a 6-second 768p clip, 81 credits ($0.81) for 10 seconds at 768p, and 71 credits ($0.71) for a 6-second 1080p clip, on Apiframe's pay-as-you-go pricing.
Do I need a MiniMax account?
No. Apiframe manages access on your behalf, with the same key and billing as every other model on the platform. Get your API key and start with free credits, or go straight to the Hailuo 2.3 model page for the full spec and live docs. If you want to see where MiniMax is headed next, our Hailuo 03 guide covers the newer multimodal successor.