Animate this starting frame into one continuous five-second shot. The adult kyudo archer steadily completes the draw, releases one arrow toward a target off camera, and holds the final follow-through. Maintain the exact face, dark hakama, long bow shape and autumn garden. The bowstring snaps once, the front sleeve settles, and a few maple leaves flutter gently. Camera makes a restrained lateral move while keeping both hands and the bow visible. Natural real-time motion, correct human anatomy, no duplicated arrows or rubber bow. Native bowstring twang and dry leaves, no dialogue, music, subtitles or logos.
MiniMax H3 Max Image to Video API
minimax/h3-max/image-to-videoMiniMax H3 Max Image to Video 将静态图像转化为带原生立体声的视频,支持首尾双帧控制与对白口型同步。它在保留源图主体身份与质感的同时,赋予画面流畅自然的物理运动与镜头调度。
拖拽文件、粘贴剪贴板素材,或输入 URL。 必填,按顺序添加 1–2 张图片:先首帧,再添加可选尾帧。
2/2 个素材
示例
REST API
快速开始
用三个步骤完成第一次调用。先运行短示例,确认接口返回 task_id,再获取生成的视频。
连接 Vidgo API
创建 API Key,将它安全保存在服务端,并通过 Authorization 请求头以 Bearer Token 发送。
- 接口地址
- POST
https://api.vidgo.ai/api/generate/submit - 认证方式
- Authorization: Bearer VIDGO_API_KEY
提交一个生成任务
选择一种语言并运行短示例。提交成功会立即返回 task_id,不会等待视频生成完成。
curl --request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "minimax/h3-max/image-to-video",
"input": {
"prompt": "Connect the supplied first and last frames in one continuous five-second documentary shot. The same conservator gently peels the thin conservation tissue away from the old fresco, lowering the removed sheet with both hands. Reveal the warm restored pigments gradually; the delicate tissue flexes naturally without melting into the wall. Keep her face, hands, pale linen shirt, chapel and fresco design consistent. Slow subtle camera push toward her pleased expression, warm dust-filled light unchanged. End on the exact supplied final composition with the sheet lowered. Native quiet paper rustling and chapel room tone, no speech or music, no text or logos.",
"duration": 5,
"resolution": "768p",
"enable_safety_checker": true,
"image_urls": [
"https://cdn.vidgo.ai/apis/models/minimax/h3-max/image-to-video/v1/01/input-01.png",
"https://cdn.vidgo.ai/apis/models/minimax/h3-max/image-to-video/v1/01/input-02.png"
]
}
}'等待并获取结果
使用返回的 task_id 查询同一个任务,直到状态变为 finished 或 failed;成功后读取 data.files[].file_url。
查询状态
GET https://api.vidgo.ai/api/generate/status/{task_id}当状态为 not_started 或 running 时,建议约每 2 秒轮询一次;到达 finished 或 failed 后停止。成功时从 data.files[].file_url 读取视频地址;长任务可逐步延长间隔,也可在提交请求顶层添加 callback_url 异步接收最终结果。
not_startedrunningfinishedfailed{
"code": 200,
"data": {
"task_id": "LFE4X1JIHVQ67QET",
"status": "running",
"created_time": "2026-10-11T23:00:59"
}
}{
"code": 200,
"data": {
"task_id": "LFE4X1JIHVQ67QET",
"status": "finished",
"files": [
{
"file_url": "https://cdn.vidgo.ai/apis/models/minimax/h3-max/image-to-video/v1/01/output.mp4",
"file_type": "video"
}
],
"created_time": "2026-10-11T23:00:59",
"error_message": null,
"progress": 100
}
}完整可运行示例
理解上面的三步流程后再展开。这里把提交、轮询、终态处理和结果读取合并在一个脚本中。
set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"
REQUEST_BODY=$(cat <<'JSON'
{
"model": "minimax/h3-max/image-to-video",
"input": {
"prompt": "Connect the supplied first and last frames in one continuous five-second documentary shot. The same conservator gently peels the thin conservation tissue away from the old fresco, lowering the removed sheet with both hands. Reveal the warm restored pigments gradually; the delicate tissue flexes naturally without melting into the wall. Keep her face, hands, pale linen shirt, chapel and fresco design consistent. Slow subtle camera push toward her pleased expression, warm dust-filled light unchanged. End on the exact supplied final composition with the sheet lowered. Native quiet paper rustling and chapel room tone, no speech or music, no text or logos.",
"duration": 5,
"resolution": "768p",
"enable_safety_checker": true,
"image_urls": [
"https://cdn.vidgo.ai/apis/models/minimax/h3-max/image-to-video/v1/01/input-01.png",
"https://cdn.vidgo.ai/apis/models/minimax/h3-max/image-to-video/v1/01/input-02.png"
]
}
}
JSON
)
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data "$REQUEST_BODY")
TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
if [ -z "$TASK_ID" ]; then
printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
exit 1
fi
while true; do
STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
--url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
--header "Authorization: Bearer $VIDGO_API_KEY")
STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')
case "$STATUS" in
finished)
printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
break
;;
failed)
printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
exit 1
;;
not_started|running)
sleep 2
;;
*)
printf 'Unexpected task status: %s
' "$STATUS" >&2
exit 1
;;
esac
done请求参数
model 和 callback_url 位于请求根层;生成参数位于 input。
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | — | 固定为 minimax/h3-max/image-to-video。 |
| callback_url | string (URL) | 否 | — | 用于接收任务完成通知的公开 HTTP(S) 地址。 |
| input | object | 是 | — | 包含生成所需具体参数的容器对象。 |
| input.prompt | string | 是 | — | 动作发展、运镜轨迹与对白描述。原始输入最多 50,000 个字符(含首尾空白),去除首尾空白后不能为空。 |
| input.duration | integer | 否 | 5 | 生成时长,支持 5–15 秒的任意整数。 |
| input.resolution | string | 否 | 768p | 视频清晰度,可选 480p、768p 或 1080p。 |
| input.enable_safety_checker | boolean | 否 | true | 是否开启生成内容安全检查器。 |
| input.image_urls | string[] | 是 | — | 包含 1–2 个公开 HTTP(S) URL 的图片数组:第 1 张为首帧,可选第 2 张为尾帧。 |
响应字段
提交响应会立即返回任务标识;随着任务推进,状态响应会补充进度、输出文件或失败信息。
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 应用层结果码,成功响应使用 0 或 200。 |
| message | string | 存在时返回便于阅读的响应或错误信息。 |
| data.task_id | string | 任务标识,用于拼接状态查询地址。 |
| data.status | string | 当前状态:not_started、running、finished 或 failed。 |
| data.created_time | string | 任务创建时间,采用日期时间格式。 |
| data.progress | number | 上游提供进度时返回的完成百分比。 |
| data.files[] | array | 任务成功后返回的生成文件列表。 |
| data.files[].file_url | string | 生成视频的公开访问地址。 |
| data.files[].file_type | string | 生成文件类型,例如 video。 |
| data.files[].watermark_url | string | null | 存在水印版本时返回对应地址。 |
| data.error_message | string | null | status 为 failed 时的失败详情。 |
任务生命周期
not_started 与 running 属于非终态;finished 与 failed 是两种终态,收到任意终态后都应停止轮询。
not_started任务已被接受,正在等待排队开始。
running视频正在生成中,请保持轮询查询。
finished任务完成,从 data.files[].file_url 读取视频地址。
failed生成失败,读取 data.error_message 了解原因并停止轮询。
轮询与错误处理
- 认证失败401 表示 Bearer API Key 缺失或无效,请在控制台确认密钥后重试。
- 参数校验400 表示请求参数不合法,请检查 image_urls 数量及 prompt 长度。
- 轮询间隔建议每 2 秒查询一次状态,长任务可按指数退避逐步延长间隔至 5 秒。
- 终态处理仅在 not_started 或 running 时轮询;收到 finished 或 failed 立即终止。
- 回调方式提供 callback_url 可以在生成完成时自动接收推送,无需持续轮询。
模型规格
| 规格 | 取值 | 说明 |
|---|---|---|
| Model | minimax/h3-max/image-to-video | 异步图像生成视频模型标识。 |
| Duration | 5–15 | 整数秒,默认值为 5 秒。 |
| Resolution | 480p | 768p | 1080p | 多档清晰度输出,默认 768p。 |
| Pricing | 10 / 16 / 32 credits/s | 分别对应 480p / 768p / 1080p 档位。 |
相关模型
MiniMax H3 Max Image to Video API 常见问题
MiniMax H3 Max Image to Video API 是什么?
MiniMax H3 Max Image to Video 是 MiniMax 推出并经深度后训练优化的图像生成视频模型。它能够以一张首帧图片或首尾双帧为基准,根据提示词指令生成 5–15 秒带原生立体声与口型同步的电影质感视频。依托强大的多模态时空扩散底座,模型在严格保留输入图片主体身份、服饰质感与构图细节的同时,注入连贯自然的物理运动与光影运镜。你可以通过 API 进行程序化调用,也可以在上方体验区直接在线试用。
MiniMax H3 Max Image to Video 支持尾帧控制吗?
支持。在 image_urls 数组中传入第二张公开图片链接即可作为结束尾帧。模型会自动规划从首帧画面自然过渡到尾帧构图的运动轨迹,非常适合制作姿态闭环、特定动作结局或平滑转场镜头。
MiniMax H3 Max Image to Video 能否保持主体人脸一致性?
可以。模型在后训练中对人物面部五官、皮肤纹理、发型发丝及服装细节进行了深度特征绑定。只要提示词中的动作幅度在自然生理范围内,生成视频中的角色在整个镜头运动过程中均能高度还原输入首帧的身份特征。
MiniMax H3 Max Image to Video 静态图像如何生成对白与口型?
当首帧图片包含清晰的人物正脸或半侧脸时,你可以在提示词中指定人物说出的具体台词(如英文短对白)。模型在单次生成中不仅能合成自然的唇形开合与面部微表情,还会同步生成对齐唇形的原生语音和环境声场。
MiniMax H3 Max Image to Video 输出分辨率与画幅如何决定?
生成的画幅比例默认严格跟随输入首帧图片的原始宽高比,无需额外配置 aspect_ratio 参数。分辨率档位支持按需指定 480p、768p 或 1080p,模型会自动在目标档位下按源图比例进行等比缩放与超分辨率补全。
MiniMax H3 Max Image to Video 如何计费?
计费依据请求参数 duration 指定的秒数与所选分辨率档位:480p 为每秒 10 积分($0.050/秒),768p 为每秒 16 积分($0.080/秒),1080p 为每秒 32 积分($0.160/秒)。传入尾帧图片并不会产生额外的图像处理费用,整体计费清晰透明。
Image to Video 与 Reference to Video 有什么区别?
Image to Video 严格以输入的第 1 张图作为开场首帧(可选第 2 张作为结束尾帧),是点对点的镜头时序起止控制;而 Reference to Video 则是将图片、视频和音频作为特征参考库,主要用于跨镜头汲取角色外貌、动作节奏或风格氛围。















