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/text-to-video",
"input": {
"prompt": "A cinematic aerial view of a coastal city at sunrise"
}
}
'{
"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 根据提示词生成 5–15 秒、480p / 768p / 1080p 的视频，支持从 21:9 到 9:16 的六种宽高比。
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/text-to-video",
"input": {
"prompt": "A cinematic aerial view of a coastal city at sunrise"
}
}
'{
"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/text-to-video。只提供提示词，不提供媒体。纯提示词生成请选择文生视频接口。
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；默认为16:9。