Hailuo 2.3 API

minimax/hailuo-2.3
Hailuo 2.3 supports creating high-quality, dynamic content for creative and commercial applications, including advertising, storytelling, and digital art.
Output
$0.728 / gen
Released
Nov 28, 2025

Overview

What is Hailuo 2.3 API?

Hailuo 2.3 is a multi-modal video generation model that combines text-to-video and image-to-video capabilities within a single system. It allows users to generate scenes from scratch using natural language or animate existing images with realistic motion and cinematic effects.

This version emphasizes predictable motion behavior, stronger visual continuity, and improved prompt alignment, making it more suitable for production workflows rather than experimental generation.

Technical Specifications

Output and Generation Parameters

Parameter Specification
Model Type Text-to-Video + Image-to-Video
Input Natural language prompt, optional image
Output Resolution 768p, 1080p
Clip Duration 6–10 seconds
Frame Rate ~24 FPS
Visual Style Cinematic, realistic, stylized

The model is optimized for short-form generation, making it particularly effective for digital content, advertising, and rapid prototyping workflows.

Hailuo 2.3 API Pricing

  • 768P 6s: $0.364;
  • 768P 10s: $0.728;
  • 1080P 6s: $0.637

‍

Core Capabilities

Unified Video Generation Pipeline

At its core, Hailuo 2.3 simplifies the video creation process by merging text-driven and image-driven generation. A single prompt can define scene composition, motion, lighting, and camera behavior, while image inputs can be expanded into dynamic sequences with minimal effort.

This flexibility makes the model equally useful for ideation and asset-based production pipelines.

Motion Realism and Physical Accuracy

One of the most noticeable improvements in Hailuo 2.3 is its handling of motion. Movements appear more natural, with better transitions between frames and more believable interactions between objects and environments.

Camera dynamics, such as pans, zooms, and tracking shots—feel smoother and more intentional, contributing to an overall cinematic quality.

Character Consistency and Expression

The model introduces enhanced character stability across frames, which is particularly important for narrative content. Facial features, identity, and emotional tone remain consistent, even in close-up shots.

Subtle micro-expressions are handled more effectively, allowing scenes to convey emotion rather than just motion.

Style Stability and Visual Coherence

Hailuo 2.3 maintains a consistent visual style throughout each clip. Whether generating photorealistic footage or stylized content, the model reduces flickering and visual drift, ensuring that scenes feel cohesive from start to finish.

Model Variants and Performance Modes

Hailuo 2.3 is designed to support different production needs through distinct operating modes. Instead of forcing a single balance between speed and quality, it allows users to choose based on their workflow.

Variant Input Support Generation Speed Output Quality Ideal Scenario
Standard Text + Image Moderate Maximum fidelity Final production assets
Fast Mode Image-focused High (~under 1 minute) Slightly reduced Iteration and testing

The Standard mode prioritizes visual accuracy and consistency, while the Fast mode accelerates generation cycles, making it easier to experiment with prompts and variations before committing to a final render.

Real-World Applications

Marketing and Commercial Content

Hailuo 2.3 is well-suited for creating short promotional videos, product showcases, and branded visual content. Its ability to maintain object consistency and stylistic control makes it valuable for commercial production.

Social Media and Creative Workflows

Content creators can quickly generate cinematic clips, animate still images, or experiment with visual storytelling formats tailored for platforms like TikTok, Instagram, and YouTube Shorts.

Concept Development and Previsualization

For filmmakers and designers, the model acts as a rapid prototyping tool. It enables quick visualization of scenes, camera angles, and narrative ideas before moving into full production.

Comparison with Other Video Models

vs Google Veo 3: Hailuo 2.3 offers superior realism in human motion and physical object interaction, with enhanced facial micro-expressions and prompt fidelity. Google Veo 3 excels in cinematic-quality video with native audio generation and excellent scene continuity. Veo 3 supports longer videos but lacks the same level of fine-grained physical realism as Hailuo 2.3.

vs Sora 2: Sora 2 targets ultra-high-resolution (up to 4K) video and longer durations (up to 60 seconds), focusing on storytelling and scene continuity. Hailuo 2.3 emphasizes physical accuracy and prompt reactivity in shorter (6-10 second) videos at Full HD. Sora 2 is better for long narrative content; Hailuo 2.3 excels in microexpression and real-time physics detail.

vs Runway Gen-4: Runway Gen-4 balances multi-scene consistency and stylized content generation suitable for creative professionals. Hailuo 2.3 outperforms in physical realism and detailed object/character interaction but offers shorter clip duration and fewer stylization options. Runway is preferred for artistic, multi-scene edits; Hailuo is ideal for photorealistic, physics-driven animation.

vs Kling 2.1: Kling 2.1 offers photorealistic video with advanced lip-syncing and extended shot capabilities targeting brand and marketing content. Hailuo 2.3 delivers enhanced micro-expressions and physical motion fidelity but supports shorter videos and less emphasis on lip-sync. Kling 2.1 is best for dialogue-heavy, branded videos; Hailuo 2.3 excels in dynamic scene and object physics.

Use cases

  • Cinematic and narrative video production with realistic human and object animation
  • Advertising and brand storytelling requiring physical realism and visual consistency
  • Digital entertainment content with dynamic scene interactions and micro-expression detail
  • Anime and stylized video creation demanding frame-consistent aesthetic quality
  • Rapid prototyping and iteration in creative workflows with fast variant support

‍

How to use Hailuo 2.3 API

Install any OpenAI-compatible SDK, point it at api.aimlapi.com/v1, and set the model to minimax/hailuo-2.3.
import requests, time

headers = {"Authorization": "Bearer " + AIMLAPI_KEY}
job = requests.post(
    "https://api.aimlapi.com/v2/video/generations",
    headers=headers,
    json={
      "model": "minimax/hailuo-2.3",
      "prompt": "A serene timelapse of clouds over a mountain range"
    },
).json()
gid = job["id"]

while True:
    res = requests.get(f"https://api.aimlapi.com/v2/video/generations?generation_id={gid}", headers=headers).json()
    if res.get("status") in ("completed", "error"):
        break
    time.sleep(5)
print(res["video"]["url"])
const headers = {
  Authorization: `Bearer ${process.env.AIMLAPI_KEY}`,
  "Content-Type": "application/json",
};
const job = await (await fetch("https://api.aimlapi.com/v2/video/generations", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "model": "minimax/hailuo-2.3",
    "prompt": "A serene timelapse of clouds over a mountain range"
  }),
})).json();

let res;
do {
  await new Promise((r) => setTimeout(r, 5000));
  res = await (await fetch(`https://api.aimlapi.com/v2/video/generations?generation_id=${job.id}`, { headers })).json();
} while (!["completed", "error"].includes(res.status));
console.log(res.video.url);
# submit the generation — the response contains the job "id"
curl -X POST https://api.aimlapi.com/v2/video/generations \
  -H "Authorization: Bearer $AIMLAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"minimax/hailuo-2.3","prompt":"A serene timelapse of clouds over a mountain range"}'

# then poll until status is "completed" — video.url holds the result
curl "https://api.aimlapi.com/v2/video/generations?generation_id={id}" -H "Authorization: Bearer $AIMLAPI_KEY"

OpenAI-compatible — swap the base URL and it works with your existing SDK.

Hailuo 2.3 API Pricing

TypePrice
Output
$0.728 / gen

Hailuo 2.3 Benchmarks

BenchmarkScoreWhat it measuresSourceRetrieved
Image-to-Video Arena
1255
Human preference Elo from blind pairwise comparisons of videos animated from the same input image, measured independently by Artificial AnalysisSourceSeptember 28, 2026
Text-to-Video Arena
1176
Human preference Elo from blind pairwise comparisons of generated videos, measured independently by Artificial AnalysisSourceSeptember 28, 2026

Hailuo 2.3 vs other models

ModelInputOutputContextBest for
Hailuo 2.3
This page
$0.728 / gen
Video generation
$0.78 / sec (variable)
Video generation
$1.95 / 1M tokens
$0.131768 / sec
Video generation
$1.014 / sec
Cinematic video + native audio

Frequently asked questions

Hailuo 2.3 takes image, text as input and returns video.

Hailuo 2.3 is priced at $0.728 / 10 sec.

Hailuo 2.3 is billed per generation — a fixed charge per output rather than by prompt length.

Yes, Hailuo 2.3 accepts image input as well as a text prompt.

Hailuo 2.3 was built by MiniMax.

Send a request to v2/video/generations with minimax/hailuo-2.3 as the model id.

Yes. Hailuo 2.3 is served through AI/ML API, so the same key and endpoint format used for other models applies.

Start building with Hailuo 2.3

Get API Key
1000+ models, one API.