Video GenerationHailuo
Hailuo 2.3
Generate high-fidelity videos with realistic motion using MiniMax's Hailuo 2.3 model.
POST /v2/videos/generate — model: "hailuo-2.3"
MiniMax Hailuo 2.3 generates videos with realistic motion, improved visual consistency, and high-fidelity stylization. Supports text-to-video and image-to-video workflows at 768p and 1080p.
See Video Generation overview for common request fields, response format, and error codes.
Model-specific parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
hailuoParams.duration | number | No | 6 | Video duration in seconds: 6 or 10 |
hailuoParams.resolution | string | No | "768p" | Video resolution: "768p" or "1080p" |
hailuoParams.image | string | No | — | Image URL for image-to-video generation |
hailuoParams.prompt_optimizer | boolean | No | — | Enable the model's built-in prompt optimizer |
Constraint: 1080p resolution does not support 10s duration.
Credit cost
| Variant | Credits |
|---|---|
768p-6s | 5 |
768p-10s | 10 |
1080p-6s | 10 |
Code examples
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"
}
}'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())const response = await fetch("https://api.apiframe.ai/v2/videos/generate", {
method: "POST",
headers: {
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({
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",
},
}),
});
console.log(await response.json());body := `{
"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"
}
}`
req, _ := http.NewRequest("POST", "https://api.apiframe.ai/v2/videos/generate",
strings.NewReader(body))
req.Header.Set("X-API-Key", "afk_your_api_key_here")
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)Try it
POST
/v2/videos/generateTry it