WaveSpeedAI APIMinimaxMinimax Hailuo 2.3 I2V Standard

Minimax Hailuo 2.3 I2V Standard

Minimax Hailuo 2.3 I2V Standard

Playground

Try it on WavespeedAI!

Hailuo 2.3 Standard - MiniMax’s next-generation AI video model ranked #2 globally. Features 2.5x efficiency improvement, 85% complex instruction response rate, and extreme physics simulation capabilities for high-quality 768p video generation.

Features

MiniMax Hailuo 2.3 — Image-to-Video (I2V) Standard

Hailuo 2.3 I2V Standard is MiniMax’s latest image-to-video model, designed to animate static images into smooth, cinematic video clips. It combines natural motion synthesis, physical realism, and character consistency — enabling creators to bring still visuals vividly to life.


🎬 Why It Looks Great

  • Cinematic Motion – Generates dynamic, camera-like movement such as panning, tracking, and zooming.
  • Physics-Aware Animation – Simulates object dynamics (wind, light reflection, motion blur) with realistic precision.
  • Consistent Structure – Preserves the original image’s composition, lighting, and character details.
  • Flexible Duration Options – Choose between 6-second and 10-second clips.
  • Professional Fidelity – Delivers filmic quality suitable for storytelling, ads, or product demos.

⚙️ Limits and Performance

  • Input: single reference image (JPEG / PNG)
  • Optional Input: text prompt to guide motion and scene behavior
  • Duration: 6 seconds or 10 seconds
  • Output resolution: 1080p

💰 Pricing

DurationResolutionCost per Job
6 seconds1080p$0.28
10 seconds1080p$0.56

🚀 How to Use

  1. Upload a reference image as your base frame.
  2. (Optional) Add a prompt describing the desired motion or action. Example: “A motorcycle drives along a winding mountain road, camera panning smoothly to follow.”
  3. Choose the duration (6 s or 10 s).
  4. Click Run and wait for processing.
  5. Download your animated video.

💡 Pro Tips

  • Keep prompts concise (1–2 sentences) to maintain visual stability.
  • Use camera verbs like pan, follow, zoom, or rotate to define motion direction.
  • For dynamic results, pick 10 s; for previews or loops, choose 6 s.
  • The model preserves fine lighting and depth details — great for cinematic storytelling and concept visuals.

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-standard" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "duration": 6,
    "enable_prompt_expansion": false
}'

# 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

ParameterTypeRequiredDefaultRangeDescription
promptstringNo-The positive prompt for the generation.
imagestringYes-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.
durationintegerNo66, 10The duration of the generated media in seconds.
enable_prompt_expansionbooleanNofalse-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

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

© 2025 WaveSpeedAI. All rights reserved.