MiniMax H3 （自部署） · Generate video

Endpoint	Method	Path
Submit task	POST	/v1/videos/generations
Query result	GET	/v1/videos/generations/{id}

Request parameters

Authorization

Add an Authorization header whose value is Bearer followed by your API key.

Authorization: Bearer ****************

Header parameters

Content-TypestringOptional

application/json

AcceptstringOptional

application/json

Body parametersapplication/jsonrequired

modelstringRequired

Model ID, fixed to `MiniMax-H3-Tokens`

contentarray[object]Required

resolutionstringRequired

480P / 768P / 2KResolution (e.g. 720P / 1080P)

durationintegerRequired

4–15Duration (seconds)

ratiostringOptional

adaptive / 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16Aspect ratio of the generated video (default adaptive)

Example

{  "model": "MiniMax-H3-Tokens",  "content": [    {      "type": "text",      "text": "Slow-motion waves hitting rocks, warm dusk tones"    }  ],  "resolution": "768P",  "duration": 5,  "ratio": "16:9"}

Request code samples

curl https://api.hotrouter.ai/v1/videos/generations \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "MiniMax-H3-Tokens",    "content": [      {        "type": "text",        "text": "Slow-motion waves hitting rocks, warm dusk tones"      }    ],    "resolution": "768P",    "duration": 5,    "ratio": "16:9"  }'

Response

Submit task

{  "task_id": "xxxxxxxx"}

Query result

{  "task": {    "id": "xxxxxxxx",    "status": "succeeded",    "content": {      "url": "https://.../video.mp4"    },    "usage": {      "output_seconds": 5    }  }}

Endpoint	Method	Path
Submit task	POST	/v1/videos/generations
Query result	GET	/v1/videos/generations/{id}

Request parameters

Authorization

Add an Authorization header whose value is Bearer followed by your API key.

Authorization: Bearer ****************

Header parameters

Content-TypestringOptional

application/json

AcceptstringOptional

application/json

Body parametersapplication/jsonrequired

modelstringRequired

Model ID, fixed to `MiniMax-H3-Tokens`

contentarray[object]Required

resolutionstringRequired

480P / 768P / 2KResolution (e.g. 720P / 1080P)

durationintegerRequired

4–15Duration (seconds)

ratiostringOptional

adaptive / 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16Aspect ratio of the generated video (default adaptive)

Example

{
  "model": "MiniMax-H3-Tokens",
  "content": [
    {
      "type": "text",
      "text": "Slow-motion waves hitting rocks, warm dusk tones"
    }
  ],
  "resolution": "768P",
  "duration": 5,
  "ratio": "16:9"
}

{  "model": "MiniMax-H3-Tokens",  "content": [    {      "type": "text",      "text": "Slow-motion waves hitting rocks, warm dusk tones"    }  ],  "resolution": "768P",  "duration": 5,  "ratio": "16:9"}

Request code samples

curl https://api.hotrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3-Tokens",
    "content": [
      {
        "type": "text",
        "text": "Slow-motion waves hitting rocks, warm dusk tones"
      }
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

curl https://api.hotrouter.ai/v1/videos/generations \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "MiniMax-H3-Tokens",    "content": [      {        "type": "text",        "text": "Slow-motion waves hitting rocks, warm dusk tones"      }    ],    "resolution": "768P",    "duration": 5,    "ratio": "16:9"  }'

Response

Submit task

{
  "task_id": "xxxxxxxx"
}

{  "task_id": "xxxxxxxx"}

Query result

{
  "task": {
    "id": "xxxxxxxx",
    "status": "succeeded",
    "content": {
      "url": "https://.../video.mp4"
    },
    "usage": {
      "output_seconds": 5
    }
  }
}

{  "task": {    "id": "xxxxxxxx",    "status": "succeeded",    "content": {      "url": "https://.../video.mp4"    },    "usage": {      "output_seconds": 5    }  }}