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-turbo/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 Turbo 图生视频
MiniMax H3 Max Turbo 图生视频 API 将首帧和可选尾帧(URL 或 Base64)生成 5–15 秒、480p–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-turbo/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-turbo/image-to-video。按顺序提供 image_urls:首帧在前,可选尾帧在后。输出跟随首帧图像;请省略 aspect_ratio。
model 和可选的 callback_url 放在请求根级。生成参数放在 input 中。
参数详情
prompt:必填的非空字符串,最多 50,000 个字符。duration:5 到 15 秒的整数;默认为 5。小数时长会被拒绝。resolution:480p、768p或1080p;默认为768p。也接受大写P。image_urls:必填数组,包含 1-2 张图片,按首帧、尾帧的顺序排列。支持公开的 HTTP(S) URL 和 Base64 图像数据。