Animate this original photograph into a five-second continuous shot. The elderly puppeteer gently pulls the strings so the small wooden marionette bows once toward the empty velvet seats, then lifts its little head. Keep the puppeteer's face, hands, puppet costume, strings and warm theater lighting consistent. He smiles and softly says, "Your turn." Subtle camera push from the puppet toward his face, plausible string tension and articulated wooden limbs. Native quiet wood clicks and synchronized brief English speech, intimate theater room tone. No extra people, no subtitles, logos or advertising.
MiniMax H3 Max Turbo Image to Video API
minimax/h3-max-turbo/image-to-videoMiniMax H3 Max Turbo Image to Video 将静态图像转为 5–15 秒视频,支持首尾帧控制与原生立体声同步。它在忠实保留源图主体与质感的同时,赋予画面逼真的物理动态。
拖拽文件、粘贴剪贴板素材,或输入 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
提交一个生成任务
按顺序提供 image_urls:首帧在前、可选尾帧在后,并填写 Prompt。
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-turbo/image-to-video",
"input": {
"prompt": "Create a single continuous five-second live-action shot connecting these exact first and last frames. The same helmeted adult BMX rider in the plain orange hoodie makes a small controlled hop from the shallow bank lip, keeps both hands on the handlebars and both feet on the pedals, and lands both wheels smoothly on the flat. Preserve the bicycle frame, wheels, helmet, face and skatepark geometry. Follow the rider with a gentle low tracking camera, without cuts, flips or spins. End at the supplied final pose and composition. Realistic short flight arc, wheel rotation, tire compression on landing and settling cloth. Native rolling tires, one soft landing sound and a satisfied breath, no music. No brands, captions or on-screen text.",
"duration": 5,
"resolution": "768p",
"enable_safety_checker": true,
"image_urls": [
"https://cdn.vidgo.ai/apis/models/minimax/h3-max-turbo/image-to-video/v1/01/input-01.png",
"https://cdn.vidgo.ai/apis/models/minimax/h3-max-turbo/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": "U5OAG5Z0DNS4ITLR",
"status": "running",
"created_time": "2026-10-11T23:09:35"
}
}{
"code": 200,
"data": {
"task_id": "U5OAG5Z0DNS4ITLR",
"status": "finished",
"files": [
{
"file_url": "https://cdn.vidgo.ai/apis/models/minimax/h3-max-turbo/image-to-video/v2/01/output.mp4",
"file_type": "video"
}
],
"created_time": "2026-10-11T23:09:35",
"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-turbo/image-to-video",
"input": {
"prompt": "Create a single continuous five-second live-action shot connecting these exact first and last frames. The same helmeted adult BMX rider in the plain orange hoodie makes a small controlled hop from the shallow bank lip, keeps both hands on the handlebars and both feet on the pedals, and lands both wheels smoothly on the flat. Preserve the bicycle frame, wheels, helmet, face and skatepark geometry. Follow the rider with a gentle low tracking camera, without cuts, flips or spins. End at the supplied final pose and composition. Realistic short flight arc, wheel rotation, tire compression on landing and settling cloth. Native rolling tires, one soft landing sound and a satisfied breath, no music. No brands, captions or on-screen text.",
"duration": 5,
"resolution": "768p",
"enable_safety_checker": true,
"image_urls": [
"https://cdn.vidgo.ai/apis/models/minimax/h3-max-turbo/image-to-video/v1/01/input-01.png",
"https://cdn.vidgo.ai/apis/models/minimax/h3-max-turbo/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 | Yes | — | minimax/h3-max-turbo/image-to-video |
| callback_url | string (URL) | No | — | HTTP(S) |
| input | object | Yes | — | 包含 prompt、image_urls、duration 等生成参数的输入对象。 |
| input.prompt | string | 是 | — | 1–50,000 个字符 |
| input.duration | integer | 否 | 5 | 5–15 秒,整数 |
| input.resolution | string | 否 | 768p | 480p | 768p | 1080p |
| input.enable_safety_checker | boolean | 否 | true | true | false |
| input.image_urls | string[] | 是 | — | 1–2 张图片,先首帧再尾帧。HTTP(S) 或 Base64 |
响应字段
提交响应会立即返回任务标识;随着任务推进,状态响应会补充进度、输出文件或失败信息。
| 字段 | 类型 | 说明 |
|---|---|---|
| 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视频正在生成,继续使用同一个 task_id 查询。
finished生成成功,从 data.files[].file_url 读取视频地址。
failed生成因错误终止,读取 data.error_message,不再继续轮询。
轮询与错误处理
- 认证失败401 表示 Bearer API Key 缺失或无效,修正凭证后再重试。
- 参数校验400 表示请求无效,应读取响应信息并修正对应字段。
- 轮询间隔初始建议约每 2 秒查询一次,长任务应逐步延长间隔。
- 终态处理仅在 not_started 或 running 时继续查询;遇到 finished 或 failed 立即停止。
- 回调方式提供 callback_url 可异步接收最终结果;否则使用状态查询接口。
模型规格
| 规格 | 取值 | 说明 |
|---|---|---|
| Model | minimax/h3-max-turbo/image-to-video | 异步图生视频端点模型标识 |
| Duration | 5–15 | 整数秒,默认 5 秒 |
| Resolution | 480p | 768p | 1080p | 默认 768p |
| Pricing | 5 / 8 / 16 credits/s | 按秒阶梯计费(480p / 768p / 1080p) |
相关模型
MiniMax H3 Max Turbo Image to Video API 常见问题
MiniMax H3 Max Turbo Image to Video API 是什么?
MiniMax H3 Max Turbo Image to Video 是 MiniMax 研发的图像驱动视频生成模型。它能够根据一张起始参考图(或首尾两张关键帧)及文本提示词,快速生成 5–15 秒连贯生动的动态视频,支持 480p、768p 与 1080p 分辨率,并原生同步生成立体声环境音效。基于先进的后训练蒸馏架构,它在实现翻倍推理吞吐的同时,精准锁开源图主体特征与物理质感。你可以通过 API 进行程序化调用,也可以在上方体验区直接在线试用。
MiniMax H3 Max Turbo Image to Video 如何使用首尾帧控制?
在请求中的 image_urls 参数中按顺序传入两张图片地址即可启用首尾帧过渡:第一张图片作为视频起始首帧,第二张图片作为视频结束尾帧。模型会自动计算并渲染两帧之间的平滑动态演变,特别适合需要精准锁定收尾构图的分镜衔接或镜头转场。若只传入一张图片,则仅作为起始首帧驱动生成。
MiniMax H3 Max Turbo Image to Video 输出画幅由什么决定?
图生视频端点的输出视频画面比例完全自动继承输入首帧图片的宽高比,因此接口不接受也不需要传入 aspect_ratio 字段。输入图片单边尺寸支持 256 至 5760 像素,宽高比在 0.4 到 2.5 之间均可良好兼容。建议在上传前将源图裁剪至目标发布画幅,以获得最理想的构图呈现。
MiniMax H3 Max Turbo 与基础版 H3 Max 在图生视频上有何差异?
MiniMax H3 Max Turbo 在继承基础旗舰版视觉审美与提示词遵循力的前提下,进行了深度的后训练推理加速。Turbo 版生成速度大约提升 2 倍,且每秒计费费率降低 50%,极大缓解了高并发视频量产的耗时与成本压力。基础版 H3 Max 则保留了更多样化的参考生视频(ref2v)多模态扩展能力。
MiniMax H3 Max Turbo Image to Video 会生成声音吗?
是的,模型原生支持同步音频生成。在将静态图像驱动为动态画面的同时,模型会结合参考图场景与提示词中的运动语义,自动合成匹配的双声道立体声音频,如环境背景音、风声、脚步声或机械运转声,无需在后期环节单独配乐。
MiniMax H3 Max Turbo 的 1080p 分辨率是原生渲染吗?
1080p 档位是通过 768p 潜空间精细化上采样(Latent refinement)增强生成的,并非纯原生 1080p 基底渲染。如果追求极致的渲染效率与性价比,建议优先选用原生 768p 档位;若需要高清晰度交付,可选用 1080p 获取更高像素密度的视觉质感。
MiniMax H3 Max Turbo Image to Video 如何计费?
API 采用按秒计费模式,费用仅取决于请求参数 duration 指定的时长与所选分辨率:480p 为每秒 5 积分(约 $0.025/秒),768p 为每秒 8 积分(约 $0.040/秒),1080p 为每秒 16 积分(约 $0.080/秒)。以默认 5 秒 768p 视频为例,单次生成消耗 40 积分($0.200)。提交任务前,体验区的运行按钮会根据当前所选参数实时显示预估费用。















