POST /v2/video_generation 创建视频生成任务,再使用 GET /v2/query/video_generation/{task_id} 查询任务结果。
核心能力
- 文生视频 — 根据文本提示生成视频。
- 图生视频 — 使用首帧、尾帧或首尾帧图片生成视频。
- 多模态参考生视频 — 将文本与参考图片、视频和音频组合使用。
- 2K 输出 — 支持官方
2K分辨率。 - 任务式生成 — 创建接口返回任务 ID,生成过程通过查询接口轮询。
模型 ID
请求体中的模型 ID 使用MiniMax-H3。
快速示例
创建一个文生视频任务:cURL
task_id:
cURL
请求内容
content 数组可以包含 text、image_url、video_url 和 audio_url。媒体文件需要使用公开可访问的 URL,不支持 Base64。媒体内容可以通过 role 指定用途,例如 first_frame、last_frame、reference_image、reference_video 和 reference_audio。
参数限制
resolution当前支持2K。duration为 4 到 15 秒之间的整数。ratio支持adaptive、21:9、16:9、4:3、1:1、3:4和9:16。文生视频必须显式指定比例;图生视频会使用输入图片比例。- 请求体总大小不能超过 64 MB。
- 图片支持 JPG、JPEG、PNG、WEBP、HEIC 和 HEIF。单张图片不超过 30 MB,宽高范围为 256 至 5760 像素,宽高比范围为 0.4 至 2.5。
- 参考视频支持 MP4 和 MOV,视频编码支持 H.264 或 H.265,音频编码支持 AAC 或 MP3。单个视频不超过 50 MB、时长为 2 至 15 秒,视频总时长不超过 15 秒。
- 参考音频支持 WAV 和 MP3。单个音频不超过 15 MB、时长为 2 至 15 秒,音频总时长不超过 15 秒。
查询任务状态
查询响应中的状态包括queued、running、succeeded、failed 和 expired。任务成功后,使用 task.content.url 获取生成的视频。
API 参考
查看 MiniMax-H3 的创建任务和查询任务接口参考。