AI Model APIVideosMiniMax-H3 Format
Image to Video
Generate video via image URLs, multipart upload, or first/last frame mode.
MiniMax-H3 supports three image-to-video approaches: image URL references, multipart file upload, and first/last frame specification.
Approach 1: Image URL
curl -X POST "http://103.36.63.156:3000/v1/videos" \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax_h3",
"prompt": "The subject slowly raises their head toward the camera, hair drifting slightly",
"image_url": "https://example.com/portrait.png",
"duration": 6
}'Approach 2: multipart Upload
Suitable for local files or images not reachable from the public internet.
curl -X POST "http://103.36.63.156:3000/v1/videos" \
-H "Authorization: Bearer sk-xxxxxxxx" \
-F "model=minimax_h3" \
-F "prompt=The buildings in the frame are gradually overgrown by plants" \
-F "duration=6" \
-F "image=@/path/to/local.png"Approach 3: First and Last Frames
Specify both the first and last frames; the model generates a transition animation between them.
curl -X POST "http://103.36.63.156:3000/v1/videos" \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax_h3",
"mode": "first_last_frame",
"prompt": "A petal going from closed to fully bloomed",
"first_frame_url": "https://example.com/first.png",
"last_frame_url": "https://example.com/last.png",
"duration": 8
}'Parameter Reference
| Parameter | Type | Description |
|---|---|---|
image_url | string | First frame image URL |
image | file | Image file uploaded via multipart |
mode | string | Set to first_last_frame to enable first/last frame mode |
first_frame_url | string | First frame image URL |
last_frame_url | string | Last frame image URL |
prompt | string | Describes the desired motion or change |
duration | number | Video duration (seconds) |
In first/last frame mode, keep the aspect ratio of both images consistent; otherwise the output may be stretched or cropped.
Reference Asset Limits
| Type | Limit |
|---|---|
| Image | 1 primary image per request (2 in first/last frame mode) |
| Video reference | 1 |
| Audio reference | 1 |
For more on reference assets, see Reference Assets.
How is this guide?