跳转到主要内容
POST
提交 MiniMax H3 参考生视频任务
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。

模型

  • minimax/h3/reference-to-video - MiniMax H3 参考生视频,2K 输出

功能

  • 参考生视频:用参考图、参考视频和可选的参考音频引导生成。
  • 2K 输出:输出分辨率固定为 2K。

输入模式

  • 至少提供一张参考图或一段参考视频。参考音频不能单独使用。
  • 所有媒体 URL 都必须可公开访问且能直接下载。

参数说明

  • prompt 必填,最多 2,000 个字符。
  • duration 接受 5 到 15 秒的整数,默认为 5。
  • resolution 仅接受 2K。
  • aspect_ratio 支持 adaptive、21:9、16:9、4:3、1:1、3:4 和 9:16。
  • 参考输入最多接受 9 张图片、3 段视频和 3 段音频。参考音频需要至少一张参考图或一段参考视频。

计费

视频生成按时长计费。每段参考视频的时长分别向下取整后计入输出时长;超过前五张的参考图会额外计费。

授权

Authorization
string
header
必填

使用 Authorization: Bearer VIDGO_API_KEY。

请求体

application/json
model
string
必填
示例:

"minimax/h3/reference-to-video"

input
object
必填

reference_image_urls、reference_video_urls 至少提供一个。

callback_url
string<uri>

可选的 Webhook 回调 URL。

响应

任务提交成功

code
integer
必填
示例:

200

data
object
必填