Create image-to-video job

​

Hailuo image-to-video

​

Quick flow

1. Submit job → get task_id
2. Poll status → wait until status is completed for a public URL

​

Basics

• Endpoint: POST /v1/video/generations
• Auth: Bearer Token (Authorization: Bearer {{YOUR_API_KEY}})
• Content-Type: application/json

​

Request body

​

Image rules

• Formats: JPG, JPEG, PNG, WebP
• Size: < 20MB
• Dimensions: short edge > 300px; aspect between 2:5 and 5:2

​

Camera commands (sample)

• Dolly: [dolly in], [dolly out]
• Truck / pedestal: [truck left], [truck right], [pedestal up], [pedestal down]
• Pan / tilt: [pan left], [pan right], [tilt up], [tilt down]
• Zoom: [zoom in], [zoom out]

Compatibility: Production may require Chinese bracket tags per the vendor. If needed, copy those literals from the Chinese documentation.

​

Example

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Contemporary dance, the people in the picture are performing, [dolly in]",
  "duration": 6,
  "metadata": {
    "first_frame_image": "https://example.com/start_frame.png",
    "resolution": "1080P",
    "prompt_optimizer": true,
    "aigc_watermark": false
  }
}

​

Response

​

Notes

1. Align prompt with image: Describe motion that fits the frame; mismatched action vs. static scene may look poor.
2. Speed: MiniMax-Hailuo-2.3-Fast for faster turnaround.
3. 10s + MiniMax-Hailuo-02: max 768P.