Model ID
Put this value in the request body's `model` field — not the display name above.
by MiniMax · MiniMax Hailuo H3 video generation (async task), native stereo audio. 4-15 sec, 768P / 2K, aspect ratios 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive. Supports text to video, first-frame / first-and-last-frame image to video, and omni-reference (≤5 reference images, ≤3 reference videos, ≤3 reference audio clips).
POST /v1/videos/generationshttps://usapi.dflop.top/v1curl https://usapi.dflop.top/v1/videos/generations \
-H "Authorization: Bearer sk-gpushare-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3",
"content": [
{"type": "text", "text": "海边日落,无人机航拍视角 --ratio 16:9"}
],
"duration": 5
}'
# 返回 {"id": "...", "status": "queued"}
# 图生视频:content 里追加 {"type":"image_url","image_url":{"url":"https://..."}}
# ⚠️ duration 缺省按 12 秒预扣,结算按实际时长 —— 建议显式传curl https://usapi.dflop.top/v1/videos/generations/$TASK_ID \
-H "Authorization: Bearer sk-gpushare-xxxxxxxx"
# status: queued -> running -> succeeded / failed / expired / cancelled
# 建议 5-10 秒轮询一次。轮询免费。This is an async task: submit for a task ID, then poll until it settles. Polling itself is free.
Billed per second of delivered video; tiered SKUs use the rate for the resolution actually delivered.
Sign in and any personal discount on your account will show up here. Sign in
Models like this bill for real per image / per second / per call and are mostly async tasks, so there is no one-click test here. Use the sample code above, or generate in the matching workbench (which has a parameter panel and a cost estimate).
Open the workbench404 model_not_foundYou passed the display name instead of the model ID.✗ Hailuo H3→✓ minimax-h3
→ Copy the Model ID at the top of this page
402 quota_exceededInsufficient account balance. All your API keys share one balance.
401 / 403The API key is invalid, or it has a model allowlist that doesn't include this ID.
→ Check the key's status and allowed models
400 invalid_request`resolution` is required on Lite (`-lite`) SKUs and only accepts 720p / 1080p; anything else also returns 400.
→ Check your request body against the sample code above
本页的 Markdown 版本：/models/minimax-h3.md