Skip to main content
POST
Hailuo 图生视频

授权

Authorization
string
header
必填

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

请求体

application/json
model
enum<string>
必填

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

可用选项:
MiniMax-Hailuo-02
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-02 模型,支持使用 [指令] 语法进行运镜控制。 可在 prompt 中通过 [指令] 格式添加运镜指令,以实现精确的镜头控制。

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

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

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

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

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

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

可用选项:
768P,
1080P

响应

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

id
string
task_id
string

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

object
string
示例:

"video"

model
string
status
string
示例:

"queued"

progress
integer
示例:

0

created_at
integer<int64>