Skip to main content
POST

创建视频(官方格式)

提交 MiniMax-H3 视频生成任务,支持文生视频、首帧/首尾帧、参考图/视频/音频等模式。

方法与路径

请求示例

响应示例

提交后使用 查询任务(官方格式) 轮询 task_id

认证

Body

string
必填
模型名称,当前仅支持 MiniMax-H3
array<object>
必填
多模态输入数组,顺序影响角色分配。
string
必填
内容类型:textimage_urlvideo_urlaudio_url
string
type=text 时必填,提示词文本。
object
type=image_url 时使用,须包含 url
string
必填
图片公网 URL。支持 JPG、JPEG、PNG、WEBP、HEIC、HEIF;单文件不超过 30 MB;宽高范围为 256~5760 px;长宽比范围为 0.4~2.5。首帧 ≤ 1 张、尾帧 ≤ 1 张、参考图 ≤ 9 张。
object
type=video_url 时使用,须包含 url
string
必填
参考视频公网 URL。支持 MP4、MOV,编码为 H.264/AVC、H.265/HEVC;单文件不超过 50 MB;个数 ≤ 3;单段 2~15 秒、总时长不超过 15 秒;宽高范围为 256~5760 px;长宽比范围为 0.4~2.5;帧率范围为 23.976~60。
object
type=audio_url 时使用,须包含 url
string
必填
参考音频公网 URL。支持 WAV、MP3;单文件不超过 15 MB;个数 ≤ 3;单段 2~15 秒、总时长不超过 15 秒。
string
媒体角色:
  • first_frame:首帧(图片)
  • last_frame:尾帧(图片)
  • reference_image:参考图
  • reference_video:参考视频
  • reference_audio:参考音频
object
视频生成参数,均为可选。
integer
视频时长(秒)。合法范围 [4, 15],默认 5
string
分辨率:768P2K,默认 2K
string
宽高比:adaptive21:916:94:31:13:49:16。文生视频默认 16:9 且不能为 adaptive;图生视频强制 adaptive
boolean
是否在生成视频中添加 AIGC 标识水印,默认 false

content 混用规则

违反以下规则可能返回 400
  • reference_image / reference_video / reference_audio 不能与 first_frame / last_frame 同时出现
  • 每次请求必须包含一个非空 text 项(prompt 必填)
  • 请求体总大小不得超过 64 MB,大文件请使用公网 URL,不要使用 Base64

生成模式对照

Response

string
任务 ID,用于 查询任务(官方格式)

相关接口