Create a video

Use the content array to combine text, first and last frames, reference images, reference videos, and reference audio. The endpoint returns a task ID.

POST/v2/video_generation

Use the content array to combine prompt text with optional first and last frames, reference images, reference videos, or reference audio. The array must contain at least one non-empty text item.

You can provide up to 9 reference images, 3 reference videos, and 3 reference audio files. Reference images, videos, and audio can be used independently or combined. Reference media cannot be combined with first- or last-frame images.

If the MiniMax upstream service returns a valid JSON error, the endpoint preserves its HTTP status code and JSON content.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization Header.

In: header

Request Body

application/json

MiniMax-H3 video generation request.

TypeScript Definitions

Use the request body type in TypeScript.

model*string

MiniMax-H3 video model ID. The recorded model is MiniMax-H3; available models are determined by the model list returned for the current API key.

Length1 <= length

content*array<|||>

Input content array. It must contain at least one non-empty text item. See each item description for limits on the number and combination of media types.

Items1 <= items

resolution*string

Output video resolution.

Value in

"768P"
"2K"

duration*integer

Output video duration in seconds, from 4 to 15.

Range4 <= value <= 15

ratio?string

Text-to-video requires a specific aspect ratio and cannot use adaptive. For first-frame, last-frame, and first-and-last-frame image-to-video, use adaptive because the input image determines the ratio. For multimodal reference-to-video, the field can be omitted to use adaptive by default, or a specific ratio can be provided.

Value in

"adaptive"
"21:9"
"16:9"
"4:3"
"1:1"
"3:4"
"9:16"

callback_url?string

MiniMax task status callback URL.

Formaturi

aigc_watermark?boolean

Whether to add an AIGC watermark.

Response Body

`application/json`

curl -X POST "https://example.com/v2/video_generation" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "content": [      {        "type": "text",        "text": "A Shanghai street after the rain, with a cinematic camera slowly moving forward as neon lights reflect on the pavement."      }    ],    "resolution": "2K",    "duration": 5,    "ratio": "16:9"  }'

{
  "task_id": "426014652088710"
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`