MiniMax H3 Max Text-to-Video
https://api.hiapi.ai /v1/tasks Image, video, and audio models are called through theUnified Async API POST /v1/tasks endpoint; only the input fields differ (see input parameters below).
Model summary
| Model ID | minimax-h3-max/text-to-video |
|---|---|
| Type | Text-to-video |
| Endpoint | POST /v1/tasks |
| Pricing | View live pricing |
Generate video from text in six aspect ratios, including landscape, portrait and square. Supports 480P, 768P, 1080P, 0.92–15 second target durations and your own audio.
Production guidance
- Use callback.url for terminal notifications and deduplicate by taskId.
- Keep polling tasks that are still processing; avoid duplicate submissions.
Request parameters
model string required Select the model to call.
input object required Video generation settings.
prompt string required Describe the scene, action, camera movement and sound in 1–50,000 characters; whitespace alone is not accepted.
duration number optional Target video duration from 0.92 to 15 seconds; fractional values are supported. Use at least 2 seconds when target_audio_url is supplied.
resolution enum optional Choose video resolution. 1080P refines a 768P base; pixel dimensions also depend on the aspect ratio.
seed integer optional Control generation randomness with an integer; 0 is valid. Omit the field to select a random seed.
prompt_expansion_mode enum optional Control prompt expansion: disabled keeps the original prompt, balanced balances expansion and wait time, and quality expands more thoroughly and may take longer.
target_audio_url string optional Replace the video soundtrack with your audio. Supply a publicly accessible HTTP(S) URL for audio at least 2 seconds long and no larger than 15 MB. Longer audio is trimmed from the start; shorter audio is padded with silence, without changing playback speed or target video duration.
aspect_ratio enum optional Width-to-height ratio of the generated video, such as 16:9 landscape, 9:16 portrait or 1:1 square.
callback object optional Callback configuration for terminal task notifications.
url string required HTTPS URL that receives task notifications.
when enum optional Notify when the task reaches a terminal state.
Example requests
Choose portrait framing and replace the soundtrack with an audio URL.
{
"model": "minimax-h3-max/text-to-video",
"input": {
"prompt": "A red paper boat drifts beneath a stone bridge after rain. Smooth tracking camera, natural ripples, soft birdsong. No text or subtitles.",
"duration": 2,
"resolution": "768P",
"target_audio_url": "https://static.hiapi.ai/model-onboarding/minimax-h3-max/2026/10/13/1791862423253-b835317bfd92f652-target-audio.wav",
"aspect_ratio": "9:16"
}
}Getting the result
- Authenticate with Authorization: Bearer YOUR_HIAPI_API_KEY and save the returned taskId.
- Poll GET /v1/tasks/{taskId}, or set callback.url to receive a terminal notification.
- Keep polling queued or processing tasks without submitting duplicates. On success, read the video URL from output[].url.
- Handle failures using the returned error. Deduplicate callbacks by taskId.
FAQ
Can I guide the opening or ending with an image?
Use minimax-h3-max/image-to-video with a first frame, a last frame or both. This endpoint accepts text and optional target audio, without frame images.
Does my audio change the video length?
No. duration sets the target video length. target_audio_url replaces the soundtrack: longer audio is trimmed from the start and shorter audio is padded with silence. Supply audio at least 2 seconds long and no larger than 15 MB.
How do I keep my original prompt without expansion?
Set prompt_expansion_mode to disabled. Select quality when you want more thorough expansion, allowing additional waiting time.