curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "minimax/h3-max/reference-to-video",
"input": {
"prompt": "Image 1 walks through a sunlit street",
"reference_image_urls": [
"https://example.com/subject.jpg"
]
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1787970600-abcd1234",
"status": "not_started",
"created_time": "2026-08-29T10:30:00Z"
}
}MiniMax / Hailuo
MiniMax H3 Max 参考生视频
根据参考图、参考视频和参考音频生成视频。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "minimax/h3-max/reference-to-video",
"input": {
"prompt": "Image 1 walks through a sunlit street",
"reference_image_urls": [
"https://example.com/subject.jpg"
]
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1787970600-abcd1234",
"status": "not_started",
"created_time": "2026-08-29T10:30:00Z"
}
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
可选参数
enable_safety_checker：布尔值，默认为true。设为false可关闭安全检查。callback_url：可选的 Webhook URL，放在请求根级。不使用回调时请查询任务状态。
使用指南
使用minimax/h3-max/reference-to-video。至少提供一张参考图，可选添加参考视频和参考音频，所有列表中的素材总数最多 12 个。按列表顺序以 Image 1、Video 1 和 Audio 1 引用素材。首帧和尾帧不能与参考素材组合使用。
model 和可选的 callback_url 放在请求根级。生成参数放在 input 中。
参数详情
prompt：必填的非空字符串，最多 50,000 个字符。duration：5 到 15 秒的整数；默认为 5。小数时长会被拒绝。resolution：480p、768p或1080p；默认为768p。aspect_ratio：六种固定比例（21:9、16:9、4:3、1:1、3:4、9:16）或adaptive；默认为adaptive。reference_image_urls：必填数组，包含 1-9 张静态 JPEG、PNG 或 WebP 图片，每张最大 30 MB。支持的比例为1:1、4:3、3:4、16:9、9:16、5:2和2:5；上传前请先校正图片方向。reference_video_urls：可选数组，最多 3 段 MP4/MOV 视频，每段最大 50 MB。每段必须为 2-15 秒，合计最多 15 秒。视频必须为恒定 24 fps、方形像素、旋转元数据为 0，比例为16:9或9:16。按请求的输出时长截取帧后，计入的帧数必须为 48、120、240 或 360。其他时长组合会被拒绝。reference_audio_urls：可选数组，最多 3 段 MP3/WAV 音频，每段最大 15 MB。每段必须为 2-15 秒，且不超过输出时长，合计最多 15 秒。音频必须为 32 kHz 的单声道或立体声，解码后的采样数能被 800 整除。- 所有参考 URL 都必须是公开的 HTTP(S) 下载链接。三个列表中的素材总数不得超过 12 个。
授权
使用 Authorization: Bearer VIDGO_API_KEY。
请求体
application/json