Video model · MiniMax
MiniMax H3 API — price and setup
minimax-h3Generate MiniMax H3 videos with one BoostRail key: submit a task, poll it, download the MP4. Billed in USD per second of video; failed tasks are not charged.
Price per second
One price per spec, billed on the seconds you request. Prices follow the live catalog.
| Spec | Price per second |
|---|---|
| 768p | $0.076 / sec |
| 2K | $0.1235 / sec |
What the API accepts
- Input: Text prompt (text to video)
- Reference images: Not accepted (requests with input_reference are rejected before they start)
- Clip length: 5 to 15 seconds
- For vertical short-drama clips, send upstream_options with aspect_ratio set to 9:16.
Submit, poll, download
The video API is asynchronous. Submitting returns a task id; poll it until the status is succeeded, then download the MP4 from the signed link in data[0].url, which is valid for 10 minutes.
# 1. Submit the task
curl https://api.boostrail.com/v1/videos \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"minimax-h3","prompt":"A woman in a red coat stops in the rain, turns to the camera and smiles","seconds":5,"size":"768p","upstream_options":{"aspect_ratio":"9:16"}}'
# 2. Poll every 10 seconds until status is succeeded, failed, cancelled or expired
curl https://api.boostrail.com/v1/videos/TASK_ID \
-H "Authorization: Bearer YOUR_API_KEY"
# 3. Download from data[0].url (a signed link, valid for 10 minutes)
curl -L -o clip.mp4 "SIGNED_URL"import time, requests
API = "https://api.boostrail.com/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
task = requests.post(f"{API}/videos", headers=HEADERS, json={
"model": "minimax-h3",
"prompt": "A woman in a red coat stops in the rain, turns to the camera and smiles",
"seconds": 5,
"size": "768p",
"upstream_options": {"aspect_ratio": "9:16"},
}).json()
while True:
status = requests.get(f"{API}/videos/{task['id']}", headers=HEADERS).json()
if status["status"] in ("succeeded", "failed", "cancelled", "expired"):
break
time.sleep(10)
if status["status"] == "succeeded":
video = requests.get(status["data"][0]["url"]) # signed link, valid for 10 minutes
with open("clip.mp4", "wb") as f:
f.write(video.content)
else:
print(status["error"]) # failed tasks are not chargedGood to know
- Failed, cancelled and expired tasks are not charged.
- Download finished videos soon: the generated file is kept for less than 6 days.
Questions about MiniMax H3
How much does MiniMax H3 cost on BoostRail?
minimax-h3 is billed per second of video: 768p $0.076, 2K $0.1235. Failed tasks are not charged.
How long can a MiniMax H3 clip be?
5 to 15 seconds per request. Longer scenes are made by joining several clips in editing.
Can MiniMax H3 make vertical 9:16 video?
Yes. Send upstream_options with aspect_ratio set to 9:16. Accepted ratios: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
Does MiniMax H3 accept reference images?
Not through BoostRail: requests with input_reference are rejected before they start, so nothing is charged. Describe the scene in the text prompt instead.
Does MiniMax H3 generate sound?
Yes. The MP4 comes with an audio track generated with the video. Music and subtitles are easier to control when added in editing.
What happens when a MiniMax H3 task fails?
Failed, cancelled and expired tasks are not charged; the amount held when you submitted is released.
How long can I download a finished MiniMax H3 video?
The signed link in data[0].url is valid for 10 minutes; poll the task again for a fresh link. content_expires_at in the task response shows how long the file stays available. The generated file is kept for less than 6 days, so download it soon.
More on video
AI short-drama studios →Short-drama cost calculator →All video models and prices →API quickstart →MiniMax documentation →