MiniMax H3 （自部署） · Generar vídeo

Endpoint	Método	Ruta
Enviar tarea	POST	/v1/videos/generations
Consultar resultado	GET	/v1/videos/generations/{id}

Parámetros de solicitud

Authorization

Añade un header Authorization cuyo valor sea Bearer seguido de tu API key.

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

Parámetros de header

Content-TypestringOpcional

application/json

AcceptstringOpcional

application/json

Parámetros de bodyapplication/jsonobligatorio

modelstringObligatorio

ID del modelo, fijo en `MiniMax-H3-Tokens`

contentarray[object]Obligatorio

resolutionstringObligatorio

480P / 768P / 2KResolución (p. ej. 720P / 1080P)

durationintegerObligatorio

4–15Duración (segundos)

ratiostringOpcional

adaptive / 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16Relación de aspecto del vídeo generado (por defecto adaptive)

Ejemplo

{  "model": "MiniMax-H3-Tokens",  "content": [    {      "type": "text",      "text": "Olas rompiendo contra las rocas a cámara lenta, tonos cálidos del atardecer"    }  ],  "resolution": "768P",  "duration": 5,  "ratio": "16:9"}

Código de ejemplo

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": "Olas rompiendo contra las rocas a cámara lenta, tonos cálidos del atardecer"      }    ],    "resolution": "768P",    "duration": 5,    "ratio": "16:9"  }'

Respuesta

Enviar tarea

{  "task_id": "xxxxxxxx"}

Consultar resultado

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

Endpoint	Método	Ruta
Enviar tarea	POST	/v1/videos/generations
Consultar resultado	GET	/v1/videos/generations/{id}

Parámetros de solicitud

Authorization

Añade un header Authorization cuyo valor sea Bearer seguido de tu API key.

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

Parámetros de header

Content-TypestringOpcional

application/json

AcceptstringOpcional

application/json

Parámetros de bodyapplication/jsonobligatorio

modelstringObligatorio

ID del modelo, fijo en `MiniMax-H3-Tokens`

contentarray[object]Obligatorio

resolutionstringObligatorio

480P / 768P / 2KResolución (p. ej. 720P / 1080P)

durationintegerObligatorio

4–15Duración (segundos)

ratiostringOpcional

adaptive / 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16Relación de aspecto del vídeo generado (por defecto adaptive)

Ejemplo

{
  "model": "MiniMax-H3-Tokens",
  "content": [
    {
      "type": "text",
      "text": "Olas rompiendo contra las rocas a cámara lenta, tonos cálidos del atardecer"
    }
  ],
  "resolution": "768P",
  "duration": 5,
  "ratio": "16:9"
}

{  "model": "MiniMax-H3-Tokens",  "content": [    {      "type": "text",      "text": "Olas rompiendo contra las rocas a cámara lenta, tonos cálidos del atardecer"    }  ],  "resolution": "768P",  "duration": 5,  "ratio": "16:9"}

Código de ejemplo

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": "Olas rompiendo contra las rocas a cámara lenta, tonos cálidos del atardecer"
      }
    ],
    "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": "Olas rompiendo contra las rocas a cámara lenta, tonos cálidos del atardecer"      }    ],    "resolution": "768P",    "duration": 5,    "ratio": "16:9"  }'

Respuesta

Enviar tarea

{
  "task_id": "xxxxxxxx"
}

{  "task_id": "xxxxxxxx"}

Consultar resultado

{
  "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    }  }}