Skip to main content
POST

MiniMax-H3 视频生成

OpenAI 兼容格式入口。接口使用 JSON 请求体,支持文生视频、图生视频与多模态参考生视频。若需统一视频格式,请见 创建视频

方法与路径

生成场景

图生视频与多模态参考生视频互斥。请求体总大小不得超过 64 MB,大文件请使用公网 URL,不要使用 Base64。

Body

string
必填
模型名称,当前仅支持 MiniMax-H3
string
必填
非空提示词,最多 7000 个字符。
integer
默认值:"5"
生成时长,范围 4~15 秒。超出范围时服务端会自动钳制到边界值。
string
默认值:"2K"
输出分辨率,可选 768P2K。大小写不敏感,无法识别的值回落为 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
可选 adaptive21:916:94:31:13:49: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
任务状态:queuedin_progresscompletedfailed
integer
任务进度百分比,范围 0~100。
integer
任务创建时间,Unix 时间戳(秒)。

错误码

相关接口