Introduction
MiniMax released Hailuo 2.3 on October 28, 2025 as the next step after Hailuo 02, together with a lighter Hailuo 2.3 Fast. This endpoint exposes both as image-to-video: you upload the frame the shot should start on, describe what happens next, and receive a silent MP4. The generation_mode field chooses between the full model and the Fast variant without changing anything else about the request.
Key features & highlights
Motion that reads as physical
MiniMax built 2.3 around fluid body movement, steadier response to camera moves and more convincing light and shadow. In our 1080p test a dancer finishing a spin kept the red silk dress swinging after she stopped, and the hem settled instead of freezing in place.
Faces that change gradually
Micro-expressions are the other headline of this release. A clip that starts on a neutral look can move through a glance, a breath and a smile within six seconds; our rainy-window test shows a slow smile building while the camera pushes in.
Two models, one request shape
standard and fast take the same image, prompt, resolution and length, so you can draft a shot in Fast and rerender the chosen prompt in standard without rewriting anything. Output follows the opening image's proportions: a 16:9 still came back as 1364 by 768 at 24 frames per second.
Request parameters
| Parameter | Required | Description |
|---|---|---|
prompt | Yes | Describe the action after the opening frame and the camera move, up to 5,000 characters. Hailuo 2.3 is silent, so dialogue is not spoken. at least 1 characters · at most 5000 characters |
image_url | Yes | Required opening frame, JPEG, PNG or WebP up to 10 MB. The clip keeps its proportions. |
generation_mode | No | standard (default) runs Hailuo 2.3; fast runs Hailuo 2.3 Fast, which finishes sooner and costs less per clip. |
resolution | No | 768p (default) or 1080p. 1080p costs more and only comes in 6-second clips. |
duration_seconds | No | 6 (default) or 10 seconds. 10 seconds needs 768p and costs more per clip. |
Pricing
Charged per clip by mode (standard or fast), resolution and length; requests MiniMax refuses or that fail are not charged.
| Specification | Price |
|---|---|
| $0.163 / request |
| $0.256 / request |
Use cases
Moving key art
Campaign stills, cover art and poster photography gain a short moving version for feeds and teasers. Light the still the way the first second of the clip should look, because the model starts exactly there.
Dance, fashion and fabric
Spins, walks and garments moving around a body are the strongest material for this model. Start from a frame already in motion and say how the move ends, so the clip has somewhere to land.
Draft reels at volume
When you need many variations of one shot, render them in Fast at 768p, compare, and spend standard mode or 1080p only on the version that goes out.
Prompt guide & pro tips
One action, then the camera
Write the prompt as a short shot description: who moves, what they do, how it ends, and what the camera does. For example, have the woman turn from the window, tuck her hair behind her ear and smile while the camera pushes in. Several unrelated actions in six seconds tend to blur together.
Respect the frame you uploaded
The opening image fixes costume, lighting and composition. Describe changes that can grow from it, such as a turn, a step or a gust of wind, rather than asking for a new outfit or location the first frame does not show.
Plan length and size together
10-second clips are available at 768p only; 1080p is 6 seconds. Keep requests suggestive rather than explicit: MiniMax screens prompts and finished clips, explicit wording is refused at once, and scenes that drift toward more revealing content can fail after several minutes. None of those requests are billed.
API quick start
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/hailuo-2.3/image-to-video",
"input": {
"duration_seconds": 6,
"generation_mode": "standard",
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
See the API reference for authentication, the complete schema, polling, and error handling.























