Skip to main content
POST
Video Generation

授权

Authorization
string
header
必填

在请求头中传入 Authorization: Bearer <token>

请求头

Content-Type
enum<string>
默认值:application/json
必填

请求体的媒介类型,请设置为 application/json 确保请求数据的格式为 JSON.

可用选项:
application/json

请求体

application/json
model
enum<string>
必填

模型名称。可用值:MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02

可用选项:
MiniMax-Hailuo-2.3,
MiniMax-Hailuo-2.3-Fast,
MiniMax-Hailuo-02
first_frame_image
string
必填

将指定图片作为视频的起始帧。支持公网 URL 或 Base64 编码的 Data URL (data:image/jpeg;base64,...)

  • 图片要求:
    • 格式:JPG, JPEG, PNG, WebP
    • 体积:小于 20MB
    • 尺寸:短边像素大于 300px,长宽比在 2:5 和 5:2 之间
prompt
string

视频的文本描述,最大 2000 字符。对于 MiniMax-Hailuo-2.3MiniMax-Hailuo-2.3-FastMiniMax-Hailuo-02 模型,支持使用 [指令] 语法进行运镜控制。 可在 prompt 中通过 [指令] 格式添加运镜指令,以实现精确的镜头控制。

  • 支持 15 种运镜指令的指令:

    • 左右移: [左移], [右移]
    • 左右摇: [左摇], [右摇]
    • 推拉: [推进], [拉远]
    • 升降: [上升], [下降]
    • 上下摇: [上摇], [下摇]
    • 变焦: [变焦推近], [变焦拉远]
    • 其他: [晃动], [跟随], [固定]
  • 使用规则:

    • 组合运镜: 同一组 [] 内的多个指令会同时生效,如 [左摇,上升],建议组合不超过 3 个
    • 顺序运镜: prompt 中前后出现的指令会依次生效,如 "...[推进], 然后...[拉远]"
    • 自然语言: 也支持通过自然语言描述运镜,但使用标准指令能获得更准确的响应
prompt_optimizer
boolean

是否自动优化 prompt,默认为 true。设为 false 可进行更精确的控制

fast_pretreatment
boolean

是否缩短 prompt_optimizer 的优化耗时,默认为 false。仅对 MiniMax-Hailuo-2.3MiniMax-Hailuo-2.3-FastMiniMax-Hailuo-02 模型生效。

duration
integer

视频时长(秒),默认值为 6。其可用值与模型和分辨率相关:

resolution
enum<string>

视频分辨率。其可用值与模型相关:

可用选项:
512P,
768P,
1080P
callback_url
string

接收任务状态更新通知的回调 URL。支持通过 callback_url 参数可以配置回调,以接收任务状态的更新的异步通知。

地址验证:配置后,MiniMax 服务器会向 callback_url 发送一个 POST 请求,请求体中包含 challenge 字段。服务端需要在 3 秒内原样返回该 challenge 值以完成验证 状态更新:验证成功后,每当任务状态变更时,MiniMax 都会向该 URL 推送最新的任务状态。推送的数据结构与调用查询视频生成任务接口的响应体一致

回调返回的"status"包括以下状态:

  • "processing" - 生成中
  • "success" - 成功
  • "failed" - 失败
aigc_watermark
boolean

是否在生成的视频中添加水印,默认为 false

响应

200 - application/json
task_id
string

视频生成任务的 ID,用于后续查询任务状态

base_resp
object