OpenAI 格式
MiniMax-H3 视频生成
使用 POST /v1/videos 创建 MiniMax-H3 异步视频生成任务。
POST
MiniMax-H3 视频生成
OpenAI 兼容格式入口。接口使用 JSON 请求体,支持文生视频、图生视频与多模态参考生视频。若需统一视频格式,请见 创建视频。方法与路径
生成场景
Body
string
必填
模型名称,当前仅支持
MiniMax-H3。string
必填
非空提示词,最多 7000 个字符。
integer
默认值:"5"
生成时长,范围 4~15 秒。超出范围时服务端会自动钳制到边界值。
string
默认值:"2K"
输出分辨率,可选
768P、2K。大小写不敏感,无法识别的值回落为 2K。string
单张输入图片,作为首帧。与
images 同时传入时优先使用本字段。支持公网 URL、mm_file://{file_id} 与 Data URL。格式支持 JPG、JPEG、PNG、WEBP、HEIC、HEIF;单文件不超过 30 MB;宽高范围为 256~5760 px;长宽比范围为 0.4~2.5。array<string>
多张输入图片。1 张作为首帧,2 张作为首帧和尾帧,3 张及以上全部作为参考图;参考图最多 9 张。
string
可选
adaptive、21:9、16:9、4:3、1:1、3:4、9:16。文生视频默认 16:9;图生视频强制 adaptive;多模态参考生视频默认 adaptive。string
单个参考视频地址。支持 MP4、MOV,编码为 H.264/H.265;单文件不超过 50 MB,时长 2~15 秒。
array<string>
多个参考视频地址,最多 3 个、总时长不超过 15 秒。与
reference_video 同时传入时优先使用本字段。string
单个参考音频地址。支持 WAV、MP3;单文件不超过 15 MB,时长 2~15 秒。
array<string>
多个参考音频地址,最多 3 个、总时长不超过 15 秒。与
reference_audio 同时传入时优先使用本字段。boolean
默认值:"false"
是否添加 AIGC 标识水印。
响应示例
Response
string
任务 ID,后续查询请使用此字段。
string
兼容旧接口的任务 ID,值与
id 相同;新接入请使用 id。string
对象类型,固定为
video。string
任务使用的模型名称。
string
任务状态:
queued、in_progress、completed 或 failed。integer
任务进度百分比,范围 0~100。
integer
任务创建时间,Unix 时间戳(秒)。