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/image-to-video",
"input": {
"prompt": "The camera glides forward",
"image_urls": [
"https://example.com/start.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 图生视频
MiniMax H3 Max 图生视频 API 将首帧图片和可选尾帧（公开 URL）生成 5–15 秒、480p / 768p / 1080p 的视频。
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/image-to-video",
"input": {
"prompt": "The camera glides forward",
"image_urls": [
"https://example.com/start.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/image-to-video。按顺序提供 image_urls：首帧在前，可选尾帧在后。输出跟随首帧图像；请省略 aspect_ratio。
model 和可选的 callback_url 放在请求根级。生成参数放在 input 中。
参数详情
prompt：必填的非空字符串，最多 50,000 个字符。duration：5 到 15 秒的整数；默认为 5。小数时长会被拒绝。resolution：480p、768p或1080p；默认为768p。image_urls：必填数组，包含 1-2 张图片，按首帧、尾帧的顺序排列。使用公开的 HTTP(S) 下载 URL。不支持 Base64。