MiniMax H3 API

Call the MiniMax H3 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-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.mp4

For image to video, use minimax-h3-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 API FAQ

What are the MiniMax H3 API model IDs?

MiniMax H3 model IDs on TeamoRouter — Text to video: minimax-h3-text-to-video; Image to video: minimax-h3-image-to-video; Reference to video: minimax-h3-reference-to-video.

What is the difference between MiniMax H3 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 videos be?

MiniMax H3 generates 4–15s clips up to 2k 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 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 API cost and how do I pay?

MiniMax H3 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.