Minimax Hailuo 2.3 I2V Pro
Playground
Try it on WavespeedAI!Hailuo 2.3 Pro is a new AI video generation model, from Hailuo AI, created on MiniMax’s evolving framework. It has been fine-tuned to deliver ultra-clear 1080P resolution and unprecedented responsiveness while even handling, the craziest of physics driven scenes.
Features
MiniMax Hailuo 2.3 — Image-to-Video (I2V) Pro
Hailuo 2.3 Pro represents the pinnacle of MiniMax’s image-to-video generation technology. It turns static images into cinematic, full-HD 1080p videos with stunning realism, seamless motion, and physics-accurate animation. Built for creators, studios, and digital storytellers, it combines next-generation motion rendering with precise visual fidelity — all in just 5 seconds per clip.
🎬 Why It Looks Great
- Native 1080p Output – Generates crisp 1080p videos directly from the model (no upscaling), ensuring perfect clarity for big screens and professional use.
- Advanced Motion Dynamics – Accurately simulates camera motion, object interactions, lighting shifts, and depth transitions.
- Realistic Physics – Handles subtle natural effects — wind, fabric movement, reflections, and shadows — with organic consistency.
- Stable Composition – Keeps subject framing, proportions, and color tone stable across all frames.
- Cinematic Color and Lighting – Fine-tuned tone mapping for film-grade warmth and visual depth.
⚙️ Limits and Performance
- Input: one reference image (JPEG / PNG)
- Optional: text prompt to guide motion or camera style
- Duration: fixed at 5 seconds
- Resolution: 1080p
💰 Pricing
| Duration | Resolution | Cost per Job |
|---|---|---|
| 5 seconds | 1080p | $0.49 |
🚀 How to Use
- Upload a reference image to define your scene or subject.
- ( Optional ) Add a text prompt to describe motion, camera angle, or lighting. Example: “A woman walks through a sunlit market as the camera slowly pans right, dust particles drifting in the air.”
- Submit your job ( fixed 5 s duration ).
- Download your cinematic video.
💡 Pro Tips
- Use camera verbs like “pan,” “zoom,” “follow,” or “orbit” to define motion clearly.
- Mention lighting mood — soft afternoon light, golden hour, neon reflections — for enhanced aesthetic control.
- Include emotion or atmosphere in your prompt to guide tone (e.g., serene, tense, romantic).
- For stable results across iterations, reuse the same seed.
- Pair your video with music or voiceovers for a complete storytelling experience.
🧩 Why Creators Love It
“Nothing else feels as cinematic straight out of the box — it just moves naturally.” “The motion and lighting look like real camera work. Perfect for film concepts and game trailers.” “The best image-to-video balance so far — clean details, zero flicker, amazing physics.”
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/minimax/hailuo-2.3/i2v-pro" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"enable_prompt_expansion": true
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | No | - | The positive prompt for the generation. | |
| image | string | Yes | - | The model generates video with the picture passed in as the first frame.Base64 encoded strings in data:image/jpeg; base64,{data} format for incoming images, or URLs accessible via the public network. The uploaded image needs to meet the following conditions: Format is JPG/JPEG/PNG; The aspect ratio is greater than 2:5 and less than 5:2; Short side pixels greater than 300px; The image file size cannot exceed 20MB. | |
| enable_prompt_expansion | boolean | No | true | - | The model automatically optimizes incoming prompts to enhance output quality. This also activates the safety checker, which ensures content safety by detecting and filtering potential risks. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |