Generate a video
minimax_create_videoGenerate a video on hailuoai.video with Hailuo 3.0, 02 / 2.3, Hailuo 01, Veo 3.1 (incl. subject reference S2V) or Seedance 2.0 / Fast / Mini, from text, a first frame (fileID), an end frame, subject images (fileID2-14 on S2V) or omni references cited in the prompt as @Image1-9, @Video1-3, @Audio1-3 (Seedance, Hailuo-3.0). Hailuo 02 / 2.3 and Veo set size and length with options; Seedance and Hailuo-3.0 with resolution and duration. Uses the account's MiniMax credits (minimax_get_features). Waits up to ~50 s, then returns the videoId for minimax_get_video. POST /videos/create.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "minimax_create_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Wait up to ~50 s for the job to finish (default true); false returns the id at once. | |
| model | No | Default T2V-01 for text, I2V-01 with a fileID. T2V-* need no image, I2V-* and S2V-* require fileID; 02, Veo-3.1, Seedance and Hailuo-3.0 take either. | |
| fileID | No | The first frame / main image (omni @Image1 on Seedance and Hailuo-3.0, the subject on S2V models): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| prompt | No | What happens in the video. Up to 2,000 characters (7,500 on Seedance, 7,000 on Hailuo-3.0, where it is required). Optional on image models; T2V-01-Director / I2V-01-Director take camera moves as [<movement>] in the prompt. | |
| account | No | The account to use; with a fileID the file's account is used: the account id from minimax_list_accounts. Omit to let the API pick one of your accounts. | |
| fileID2 | No | fileID2: an extra image reference (S2V subject image, or omni @Image2 on Seedance and Hailuo-3.0, which stop at fileID9); fill slots in order after fileID: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| fileID3 | No | fileID3: an extra image reference (S2V subject image, or omni @Image3 on Seedance and Hailuo-3.0, which stop at fileID9); fill slots in order after fileID: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| fileID4 | No | fileID4: an extra image reference (S2V subject image, or omni @Image4 on Seedance and Hailuo-3.0, which stop at fileID9); fill slots in order after fileID: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| fileID5 | No | fileID5: an extra image reference (S2V subject image, or omni @Image5 on Seedance and Hailuo-3.0, which stop at fileID9); fill slots in order after fileID: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| fileID6 | No | fileID6: an extra image reference (S2V subject image, or omni @Image6 on Seedance and Hailuo-3.0, which stop at fileID9); fill slots in order after fileID: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| fileID7 | No | fileID7: an extra image reference (S2V subject image, or omni @Image7 on Seedance and Hailuo-3.0, which stop at fileID9); fill slots in order after fileID: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| fileID8 | No | fileID8: an extra image reference (S2V subject image, or omni @Image8 on Seedance and Hailuo-3.0, which stop at fileID9); fill slots in order after fileID: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| fileID9 | No | fileID9: an extra image reference (S2V subject image, or omni @Image9 on Seedance and Hailuo-3.0, which stop at fileID9); fill slots in order after fileID: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| maxJobs | No | Override the account's maxJobs (generations at once) for this request, 1-10. | |
| options | No | Size and length for 02 (512p only image-to-video), T2V-2.3 / I2V-2.3 / I2V-2.3-Fast (768p or 1080p) and Veo-3.1* (veo-*). Not for Hailuo 01, Seedance or Hailuo-3.0. | |
| duration | No | Seconds, Seedance and Hailuo-3.0 only: 4-15 (default 5). | |
| fileID10 | No | fileID10: an extra image reference (S2V subject image, or omni @Image10 on Seedance and Hailuo-3.0, which stop at fileID9); fill slots in order after fileID: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| fileID11 | No | fileID11: an extra image reference (S2V subject image, or omni @Image11 on Seedance and Hailuo-3.0, which stop at fileID9); fill slots in order after fileID: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| fileID12 | No | fileID12: an extra image reference (S2V subject image, or omni @Image12 on Seedance and Hailuo-3.0, which stop at fileID9); fill slots in order after fileID: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| fileID13 | No | fileID13: an extra image reference (S2V subject image, or omni @Image13 on Seedance and Hailuo-3.0, which stop at fileID9); fill slots in order after fileID: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| fileID14 | No | fileID14: an extra image reference (S2V subject image, or omni @Image14 on Seedance and Hailuo-3.0, which stop at fileID9); fill slots in order after fileID: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| replyRef | No | Optional reference of yours, stored and returned with the result and webhook. Up to 1,024 characters. | |
| replyUrl | No | Optional webhook: the API POSTs the finished result (same shape as the get tool's record) to this URL. Up to 1,024 characters. | |
| resolution | No | Seedance and Hailuo-3.0 only: 480 / 720 (Seedance, default 720), 1080 / 4K (Seedance-2.0 only), 768 / 1440 = 2K (Hailuo-3.0, default 1440). | |
| aspectRatio | No | Veo-3.1*: 16:9 (default) or 9:16. Seedance and Hailuo-3.0: Auto (match the references), 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Other models take the image's ratio. | |
| audioFileID1 | No | audioFileID1: an MP3 / WAV omni reference cited as @Audio1 (Seedance and Hailuo-3.0; 2-15 s each, 15 s in all; not with end_frame_fileID; fill in order): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| audioFileID2 | No | audioFileID2: an MP3 / WAV omni reference cited as @Audio2 (Seedance and Hailuo-3.0; 2-15 s each, 15 s in all; not with end_frame_fileID; fill in order): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| audioFileID3 | No | audioFileID3: an MP3 / WAV omni reference cited as @Audio3 (Seedance and Hailuo-3.0; 2-15 s each, 15 s in all; not with end_frame_fileID; fill in order): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| videoFileID1 | No | videoFileID1: an MP4 omni reference cited as @Video1 (Seedance and Hailuo-3.0; 2-15 s each, 15 s in all; not with end_frame_fileID; fill in order): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| videoFileID2 | No | videoFileID2: an MP4 omni reference cited as @Video2 (Seedance and Hailuo-3.0; 2-15 s each, 15 s in all; not with end_frame_fileID; fill in order): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| videoFileID3 | No | videoFileID3: an MP4 omni reference cited as @Video3 (Seedance and Hailuo-3.0; 2-15 s each, 15 s in all; not with end_frame_fileID; fill in order): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| end_frame_fileID | No | The last frame (02 at 768p / 1080p, Veo-3.1, Veo-3.1-Fast, Seedance, Hailuo-3.0); not the same file as fileID, not with omni references: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| promptOptimization | No | Let MiniMax rewrite the prompt (default false). |