Hailuo H3 Reference to Video
Hailuo H3 (MiniMax-H3) reference-to-video: drive generation with reference images, videos and audio. Output is always 2K.
At least one ref_imgs or ref_videos item is required — audio alone is not accepted. First/last frames are not supported here; use the hailuo_h3 model for those.
Pricing: billed per second — 2K is 7.15 tokens/s ($0.143/s). 768P (4.95 tokens/s) is coming soon.
Returns an img_uuid; poll GET /api/v1/jobs/detail (or use custom_callback_url) to get the generated video.
Headers
Body
Model name. Must be hailuo_h3_refs.
hailuo_h3_refs Text prompt describing the video. Required. Max 7000 characters.
7000Reference images (up to 9). JPG/PNG/WEBP/HEIC/HEIF, ≤30MB each, 256–5760px, aspect ratio 0.4–2.5.
9Reference videos (up to 3). mp4/mov, 2–15s each and ≤15s total, ≤50MB each, frame rate 23.976–60.
3Reference audio (up to 3). wav/mp3, 2–15s each and ≤15s total, ≤15MB each. Requires at least one ref_imgs or ref_videos item.
3Output resolution. Only 2K is available today; 768P is coming soon.
2K Video duration in seconds. Any integer from 4 to 15.
4 <= x <= 15Aspect ratio. Defaults to adaptive (chosen automatically from the reference assets).
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.
"https://your-server.com/goenhance/callback"
