Minimax H3 Text-to-Video
- Generate video from a non-empty text prompt
- Output duration:
5–15seconds; currently only2kis supported - Image, video, and audio inputs are not supported
- Asynchronous processing; use the returned task ID to query status
- Generated video URLs are valid for 24 hours; save them promptly
Authorizations
##All endpoints require Bearer Token authentication##
Get API Key:
Visit the API Key Management Page to obtain your API Key
Add to request header:
Body
Video generation model name
minimax-h3-text-to-video "minimax-h3-text-to-video"
Describe the video you want to generate.
Prompt requirements:
- Required and cannot be empty
- Chinese and English are supported
- We recommend no more than
500Chinese characters or1000English words; the model may ignore some details in an overly long prompt
Input restrictions:
- This is a text-to-video model and accepts text input only
image_start,image_end,image_urls,video_urls, andaudio_urlsare not supported- Supplying any of these media fields returns a parameter error
1"Epic space-opera theatrical teaser: a female captain stands alone before a massive observation window as the last fleet gathers outside. The fleet jumps away in a blinding flash and the bridge shakes; when the light fades, she is left alone in silent deep space. Cinematic lighting, slow dolly-in, grand yet restrained mood."
Output video duration in seconds. Defaults to 5 seconds.
Value restrictions:
- Only integers from
5through15, inclusive, are supported - Decimals, numeric strings,
auto, and-1are not supported - Output duration directly affects billing
5 <= x <= 155
Output video resolution. Defaults to 2k.
Available value:
2k: the only resolution currently supported
Notes:
768pis not yet available and returns a parameter error- Output bitrate, frame rate, video codec, and audio codec are selected by the platform and are not configurable
2k "2k"
Output video aspect ratio. Defaults to adaptive.
Available values:
adaptive: the model selects a suitable ratio from the prompt21:9: ultrawide16:9: landscape4:3: standard landscape1:1: square3:4: standard portrait9:16: portrait
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 "adaptive"
HTTPS callback URL for task completion
Callback timing:
- Triggered when the task is completed or failed
- Sent after billing confirmation is complete
Security restrictions:
- Only HTTPS protocol is supported
- Callbacks to private IP addresses are prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
- URL length must not exceed
2048characters
Callback mechanism:
- Timeout:
10seconds - Up to
3retries after failure (at1/2/4seconds after failure respectively) - Callback response body format is consistent with the task query endpoint response format
- A 2xx status code is considered successful; other status codes trigger retries
^https://"https://your-domain.com/webhooks/video-task-completed"
Response
Video generation task created successfully
Task creation timestamp
1761313744
Task ID
"task-unified-1774857405-abc123"
Actual model name used
"minimax-h3-text-to-video"
Specific type of the task
video.generation.task Task progress percentage (0-100)
0 <= x <= 1000
Task status
pending, processing, completed, failed "pending"
Video task details
Output type of the task
text, image, audio, video "video"
Usage and billing information