图生视频任务
授权
在请求头中传入 Authorization: Bearer <token>。
请求头
请求体的媒介类型,请设置为 application/json 确保请求数据的格式为 JSON.
application/json 请求体
模型名称。可用值:MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02。
MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02 视频的文本描述,最大 2000 字符。对于 MiniMax-Hailuo-2.3、MiniMax-Hailuo-2.3-Fast、MiniMax-Hailuo-02 模型,支持使用 [指令] 语法进行运镜控制。
可在 prompt 中通过 [指令] 格式添加运镜指令,以实现精确的镜头控制。
-
支持 15 种运镜指令的指令:
- 左右移: [左移], [右移]
- 左右摇: [左摇], [右摇]
- 推拉: [推进], [拉远]
- 升降: [上升], [下降]
- 上下摇: [上摇], [下摇]
- 变焦: [变焦推近], [变焦拉远]
- 其他: [晃动], [跟随], [固定]
-
使用规则:
- 组合运镜: 同一组 [] 内的多个指令会同时生效,如 [左摇,上升],建议组合不超过 3 个
- 顺序运镜: prompt 中前后出现的指令会依次生效,如 "...[推进], 然后...[拉远]"
- 自然语言: 也支持通过自然语言描述运镜,但使用标准指令能获得更准确的响应
是否自动优化 prompt,默认为 true。设为 false 可进行更精确的控制
是否缩短 prompt_optimizer 的优化耗时,默认为 false。仅对
MiniMax-Hailuo-2.3、MiniMax-Hailuo-2.3-Fast 和 MiniMax-Hailuo-02
模型生效。
视频时长(秒),默认值为 6。其可用值与模型和分辨率相关:
视频分辨率。其可用值与模型相关:
512P, 768P, 1080P 接收任务状态更新通知的回调 URL。支持通过 callback_url 参数可以配置回调,以接收任务状态的更新的异步通知。
地址验证:配置后,MiniMax 服务器会向 callback_url 发送一个 POST 请求,请求体中包含 challenge 字段。服务端需要在 3 秒内原样返回该 challenge 值以完成验证 状态更新:验证成功后,每当任务状态变更时,MiniMax 都会向该 URL 推送最新的任务状态。推送的数据结构与调用查询视频生成任务接口的响应体一致
回调返回的"status"包括以下状态:
"processing"- 生成中"success"- 成功"failed"- 失败
是否在生成的视频中添加水印,默认为 false