MiniMax H3 Max API
MiniMax H3 Max by MiniMax for text to video, image to video, reference to video, 4–15s clips up to 768p with audio. Call it through TeamoRouter's OpenAI-compatible /v1/videos endpoint with one API key.
MiniMax H3 Max model IDs and parameters
| Mode | Model ID | Duration | Resolution | Aspect ratio | Audio |
|---|---|---|---|---|---|
| Text to video | minimax-h3-max-text-to-video | 4–15s | 768p | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 | Yes |
| Image to video | minimax-h3-max-image-to-video | 4–15s | 768p | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 | Yes |
| Reference to video | minimax-h3-max-reference-to-video | 4–15s | 768p | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 | Yes |
Call the MiniMax H3 Max API
Video generation is asynchronous: create a job, poll it, then download the MP4. Replace $TEAMO_API_KEY with your API key.
# 1. Create a video job
curl https://api.teamorouter.com/v1/videos \
-H "Authorization: Bearer $TEAMO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"minimax-h3-max-text-to-video","prompt":"A small dog running on grass","seconds":"4"}'
# 2. Poll until status is completed
curl https://api.teamorouter.com/v1/videos/<video_id> -H "Authorization: Bearer $TEAMO_API_KEY"
# 3. Download the MP4
curl -L https://api.teamorouter.com/v1/videos/<video_id>/content -H "Authorization: Bearer $TEAMO_API_KEY" -o video.mp4For image to video, use minimax-h3-max-image-to-video and pass the first frame in input_reference.image_url (a URL or data URL).
Pricing: billed per second of generated video; live prices are in the Video Studio.
MiniMax H3 Max API FAQ
- What are the MiniMax H3 Max API model IDs?
- MiniMax H3 Max model IDs on TeamoRouter — Text to video: minimax-h3-max-text-to-video; Image to video: minimax-h3-max-image-to-video; Reference to video: minimax-h3-max-reference-to-video.
- What is the difference between MiniMax H3 Max text-to-video and image-to-video?
- Text to video creates a clip from a prompt only. Image to video animates the image you pass in input_reference as the first frame, and reference to video uses your images as references for characters, objects or style.
- How long and what resolution can MiniMax H3 Max videos be?
- MiniMax H3 Max generates 4–15s clips up to 768p in 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, with optional audio. Pass seconds as an integer string; if size is omitted, the model's first supported resolution and aspect ratio are used.
- How do I call the MiniMax H3 Max API?
- Send POST /v1/videos with the model ID and prompt, poll GET /v1/videos/{video_id} until status is completed, then download from /v1/videos/{video_id}/content. The endpoint follows OpenAI Videos, so the OpenAI SDK's client.videos.create works with base_url https://api.teamorouter.com/v1. Video generation API docs.
- How much does the MiniMax H3 Max API cost and how do I pay?
- MiniMax H3 Max is billed per second of generated video. New accounts start with a $0 balance — top up from $5 by card, then usage is deducted per job with no subscription. Live prices are shown in the Video Studio. Top up.