Skip to main content

MiniMax-H3 create video

POST 
/v1/videos

Create an asynchronous MiniMax-H3 video generation task. This is not the official MiniMax Hailuo channel (MiniMax-Hailuo-2.3). Use model MiniMaxAI/MiniMax-H3.

Request flow​

  1. Call POST /v1/videos to submit a task; the response status is usually queued
  2. Save id (same as task_id)
  3. Poll GET /v1/videos/{video_id} every 2–5 seconds until completed or failed
  4. Download via GET /v1/videos/{video_id}/content, or use metadata.url

Not supported: /v1/videos/{video_id}/remix, channel admin “Test” button, local image/video file upload, or Base64 data URIs. First/last frames must be public URLs.

Modes​

  • Text-to-video: prompt only
  • First-frame image-to-video: images[0], image, input_reference, or metadata.first_img_url
  • Last-frame image-to-video: metadata.last_img_url
  • First and last frames: pass both
  • prompt is required when there is no reference image; with a reference image it may be empty

Request example​

curl -X POST "https://open-api.fancyai.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMaxAI/MiniMax-H3",
    "prompt": "A cat walking on a rainy neon street, cinematic camera push-in",
    "seconds": "5",
    "size": "16:9"
  }'

Request​

Responses​

Task submitted successfully