Video models
MiniMax H3 (Hailuo-03)
On this page
MiniMax H3 (Hailuo-03) — high-quality AI video generation.
| modelId | minimax-h3-text-to-video, minimax-h3-image-to-video, minimax-h3-reference-to-video |
| Modality | video |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| Text To Video | minimax-h3-text-to-video | POST /api/v1/generate | prompt, duration, resolution, aspect_ratio |
| Image To Video | minimax-h3-image-to-video | POST /api/v1/generate | prompt, duration, resolution |
| Reference To Video | minimax-h3-reference-to-video | POST /api/v1/generate | prompt, duration, resolution, aspect_ratio |
| Poll task | — | GET /api/v1/task/{id}?model=minimax-h3-text-to-video | — |
Text To Video — minimax-h3-text-to-video
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | Video description prompt. Max 7000 characters. (default: A luminous spiral conch shell rests on black volcanic sand as the tide draws back, faint bioluminescence tracing its ridges, slow forward camera move. Audio: shallow waves, wind over wet sand, one low resonant tone.) |
| duration | number | Yes | Video duration in seconds. Available values: 4-15. (range 4-15) (default: 15) |
| resolution | string | Yes | Options: 768P | 2K (default: 768P) |
| aspect_ratio | string | Yes | The ratio of output video. (options: 21:9 | 16:9 | 4:3 | 1:1 | 3:4 | 9:16) (default: 21:9) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"minimax-h3-text-to-video","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","duration":15,"resolution":"768P","aspect_ratio":"21:9"}}'Image To Video — minimax-h3-image-to-video
| Field | Type | Required | Values / example |
|---|---|---|---|
| first_frame_url | string | No | Click to upload or drag and drop images. JPEG/JPG/PNG/WEBP, max 30MB each. (image URL) |
| last_frame_url | string | No | Click to upload or drag and drop images. JPEG/JPG/PNG/WEBP, max 30MB each. (image URL) |
| prompt | string | Yes | Video description prompt Max 7000 characters. (default: Animate from the first frame: light shifts slowly across the scene as the camera pushes gently forward, everything else held steady.) |
| duration | number | Yes | Video duration in seconds. Available values: 4-15. (range 4-15) (default: 12) |
| resolution | string | Yes | Options: 768P | 2K (default: 768P) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"minimax-h3-image-to-video","input":{"first_frame_url":"https://example.com/input.jpg","last_frame_url":"https://example.com/input.jpg","prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","duration":12,"resolution":"768P"}}'Reference To Video — minimax-h3-reference-to-video
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | Video description prompt. Max 7000 characters. (default: Follow the reference image's subject and palette: hold the composition and let only light and fine detail move, slow forward camera.) |
| reference_image_urls | string[] | No | reference images. (image URL) |
| reference_video_urls | string[] | No | reference videos. (image URL) |
| reference_audio_urls | string[] | No | reference audios. (image URL) |
| duration | number | Yes | Video duration in seconds. Available values: 4-15. (range 4-15) (default: 15) |
| resolution | string | Yes | Options: 768P | 2K (default: 768P) |
| aspect_ratio | string | Yes | The ratio of output video. (options: adaptive | 21:9 | 16:9 | 4:3 | 1:1 | 3:4 | 9:16) (default: 16:9) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"minimax-h3-reference-to-video","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","reference_image_urls":["https://example.com/input.jpg"],"reference_video_urls":["https://example.com/input.mp4"],"reference_audio_urls":["https://example.com/input.mp3"],"duration":15,"resolution":"768P","aspect_ratio":"16:9"}}'