Skip to main content
MiniMax-H3 provides asynchronous multimodal video generation. Create a task with POST /v2/video_generation, then query it with GET /v2/query/video_generation/{task_id}.

​
Create task

POST /v2/video_generation
cURL
200

​
Request headers

​
string
required
Bearer authentication in the form Bearer YOUR_API_KEY.
​
string
default:"application/json"
required
Request body format.

​
Request parameters

​
string
required
Use MiniMax-H3.
​
object[]
required
Multimodal content parts. Each item uses text, image_url, video_url, or audio_url.
​
string
required
Content type: text, image_url, video_url, or audio_url.
​
string
Text prompt. A text part is required for video generation.
​
string
Media role such as first_frame, last_frame, reference_image, reference_video, or reference_audio.
​
string
Public image URL. Base64 is not supported.
​
string
Public video URL for multimodal reference input.
​
string
Public audio URL for multimodal reference input.
​
string
required
Currently 2K.
​
integer
required
Video duration in seconds, from 4 to 15.
​
string
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16. Text-to-video requires an explicit ratio.
​
string
Optional callback URL for task status updates.
​
boolean
default:"false"
Whether to add an AIGC watermark.

​
Content rules

  • Text-to-video accepts one text part.
  • Image-to-video accepts a first frame, last frame, or both. Use first_frame and last_frame roles when supplying both.
  • Reference-to-video can combine reference images, video, and audio, but must include at least one reference image or video; audio alone is not sufficient.
  • First/last-frame roles cannot be mixed with reference-media roles.
  • The total request body is limited to 64 MB. Images support JPG, JPEG, PNG, WEBP, HEIC, and HEIF; each image is limited to 30 MB.
  • Reference videos support MP4/MOV, H.264/H.265, and AAC/MP3 audio; each is limited to 50 MB and 2-15 seconds. Reference audio supports WAV/MP3 and is limited to 15 MB and 2-15 seconds.

​
Response

​
string
Video generation task ID. Use it with the query endpoint.