Skip to main content
POST
Hailuo 尾帧图生视频

授权

Authorization
string
header
必填

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

请求体

application/json
model
enum<string>
必填

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

注意:首尾帧生成功能不支持 512P 分辨率。

可用选项:
MiniMax-Hailuo-02
images
string[]
必填

首尾帧图片数组,顺序固定为 [首帧, 尾帧]。每张图片支持公网 URL 或 Base64 编码的 Data URL (data:image/jpeg;base64,...)

  • 起始帧:将指定图片作为视频的起始帧。⚠️ 生成视频尺寸遵循首帧图片

  • 结束帧:将指定图片作为视频的结束帧。当首尾帧图片尺寸不一致时,模型将参考首帧对尾帧图片进行裁剪

  • 图片要求:

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

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

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

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

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

视频时长(秒),默认值为 6。首尾帧生成可用值与分辨率相关:

可用选项:
6,
10
size
enum<string>

视频分辨率。首尾帧生成支持 768P 和 1080P:

可用选项:
768P,
1080P

响应

提交成功,返回统一 OpenAI 风格视频任务对象。

id
string
task_id
string

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

object
string
示例:

"video"

model
string
status
string
示例:

"queued"

progress
integer
示例:

0

created_at
integer<int64>