MiniMax-Hailuo-02 비디오 생성
Generate videos using MiniMax Hailuo 02 model, supporting text-to-video, image-to-video, and first-last-frame generation
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
- Async task API, returns task ID upon submission
- Supported model:
MiniMax-Hailuo-02 - Three generation modes: text-to-video, image-to-video, first-last-frame generation
- Supports 512P / 768P / 1080P resolution, 6-second and 10-second duration
Please provide publicly accessible image URLs. Do not pass base64 image data directly in image_urls or metadata; upload local images first using the Upload 이미지 API to get URLs.
인증
Authorizationstring헤더필수All endpoints require Bearer Token authentication.
Authorization: Bearer YOUR_API_KEY요청 파라미터
modelstring본문필수모델 name, fixed as MiniMax-Hailuo-02.
promptstring본문Video content description, max 2000 characters.
- 필수 for text-to-video mode
- 선택 for image-to-video and first-last-frame modes (can describe desired motion)
Supports 15 camera directives (e.g., [Push in], [Pull out], [Pan left, Pedestal up]), see the Camera Directives table below.
Example: "A mouse runs toward the camera, smiling and blinking"
durationinteger본문기본값: 6Video duration in seconds.
Options: 6 or 10
When using 1080P resolution, only 6 seconds is supported.
resolutionstring본문기본값: 768PVideo resolution.
Options:
512P- Standard definition (available for image-to-video)768P- HD (default)1080P- Full HD (6-second duration only)
image_urlsstring[]본문First frame image URL array.
- Not provided: text-to-video
- 1 image: image-to-video, image used as video starting frame
Image requirements:
- Format: JPG, JPEG, PNG, WebP
- Size: under 20MB
- Dimensions: short side > 300px, aspect ratio between 2:5 and 5:2
Example: ["https://example.com/first-frame.jpg"]
metadataobject본문Extended parameters.
Show metadata fields
last_frame_imagestring본문Last frame image URL for first-last-frame generation mode.
When provided, the system generates a transition video from the first frame to the last frame.
- When both
image_urls(first frame) andlast_frame_image(last frame) are provided, video dimensions follow the first frame - If first and last frame sizes differ, the model crops the last frame based on the first frame
- First-last-frame mode does not support 512P resolution
Image requirements are the same as image_urls.
Example: "https://example.com/last-frame.jpg"
prompt_optimizerboolean본문기본값: trueAuto-optimize prompt. Set to false for more precise control.
fast_pretreatmentboolean본문기본값: falseShorten prompt optimization time. Speeds up processing when enabled.
aigc_watermarkboolean본문기본값: falseWhether to add watermark to the generated video.
callback_urlstring본문ToAPIs 최종 Task Webhook입니다. Token URL과 secret을 먼저 설정하세요. Webhook.
Three Generation Modes
| Mode | image_urls | metadata.last_frame_image | 설명 |
|---|---|---|---|
| Text-to-Video | Not provided | Not provided | Generate video from text description |
| Image-to-Video | ✅ 1 image | Not provided | Generate video with image as first frame |
| First-Last-Frame | ✅ 1 image (first frame) | ✅ Provided (last frame) | Generate transition video from first to last frame |
Resolution and Duration Combinations
| Resolution | Supported Durations | Text-to-Video | Image-to-Video | First-Last-Frame |
|---|---|---|---|---|
| 512P | 6s, 10s | ✅ | ✅ | ❌ |
| 768P | 6s, 10s | ✅ | ✅ | ✅ |
| 1080P | 6s | ✅ | ✅ | ✅ |
Camera Directives
Use [directive] syntax in prompt to control camera movement:
| Category | Directives |
|---|---|
| Pan | [Pan left] [Pan right] |
| Tilt | [Tilt up] [Tilt down] |
| Push/Pull | [Push in] [Pull out] |
| Pedestal | [Pedestal up] [Pedestal down] |
| Truck | [Truck left] [Truck right] |
| Zoom | [Zoom in] [Zoom out] |
| Other | [Shake] [Tracking shot] [Static shot] |
Usage rules:
- Combine up to 3 directives in one bracket for simultaneous movement, e.g.,
[Pan left, Pedestal up] - Sequence directives in the prompt for ordered camera moves, e.g.,
"...[Push in], then...[Pull out]"
응답
idstringTask ID for querying task status.
objectstringObject type, always generation.task.
modelstring모델 name used for this request.
statusstringTask status: queued, in_progress, completed, or failed.
created_atintegerTask creation timestamp.
Examples
Text-to-Video
{
"model": "MiniMax-Hailuo-02",
"prompt": "City night scene, neon lights flickering, traffic flowing [Push in]",
"duration": 6,
"resolution": "1080P"
}Image-to-Video
{
"model": "MiniMax-Hailuo-02",
"prompt": "Person slowly turns around, smiling",
"image_urls": ["https://example.com/portrait.jpg"],
"duration": 6,
"resolution": "768P"
}First-Last-Frame Generation
{
"model": "MiniMax-Hailuo-02",
"prompt": "A little girl grows up",
"image_urls": ["https://example.com/child.jpg"],
"duration": 6,
"resolution": "1080P",
"metadata": {
"last_frame_image": "https://example.com/adult.jpg"
}
}Camera Control
{
"model": "MiniMax-Hailuo-02",
"prompt": "A man picks up a book [Pedestal up], then reads [Static shot]",
"duration": 6,
"resolution": "768P"
}10-Second Long Video + Fast Preprocessing
{
"model": "MiniMax-Hailuo-02",
"prompt": "Waves crashing on the beach at sunset, golden light shimmering on the water",
"duration": 10,
"resolution": "768P",
"metadata": {
"prompt_optimizer": true,
"fast_pretreatment": true
}
}Video generation is an async task. Use Get Video Task 상태 to query progress and results.
요청 예시
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "MiniMax-Hailuo-02",
"prompt": "City night scene, neon lights flickering, traffic flowing",
"duration": 6,
"resolution": "1080P"
}'import requests
response = requests.post(
"https://toapis.com/v1/videos/generations",
headers={
"Authorization": "Bearer your-ToAPIs-key",
"Content-Type": "application/json",
},
json={
"model": "MiniMax-Hailuo-02",
"prompt": "City night scene, neon lights flickering, traffic flowing",
"duration": 6,
"resolution": "1080P",
},
)
print(response.json())const response = await fetch("https://toapis.com/v1/videos/generations", {
method: "POST",
headers: {
Authorization: "Bearer your-ToAPIs-key",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "MiniMax-Hailuo-02",
prompt: "City night scene, neon lights flickering, traffic flowing",
duration: 6,
resolution: "1080P"
})
});
console.log(await response.json());응답 예시
{
"id": "vid_01K8SGYNNNVBQTXNR4MM964S7K",
"object": "generation.task",
"model": "MiniMax-Hailuo-02",
"status": "queued",
"progress": 0,
"created_at": 1768380224,
"metadata": {}
}