创建文生视频生成任务

​

(海螺 Hailuo 视频)

​

快速开始

1. 提交任务 → 获得 task_id
2. 轮询状态 → 等待 status 变为 completed 返回公网链接

​

📌 基础信息

• 接口地址: POST /v1/video/generations
• 认证方式: Bearer Token (Authorization: Bearer {{YOUR_API_KEY}})
• 内容类型: application/json

​

📥 请求参数 (Request Body)

​

🎥 运镜控制指令详解

• 位移: [左移], [右移], [上升], [下降]
• 旋转/摇移: [左摇], [右摇], [上摇], [下摇]
• 空间: [推进], [拉远], [变焦推近], [变焦拉远]
• 特殊: [晃动], [跟随], [固定]

​

📤 响应结果 (Response)

​

📝 请求示例

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "一只奔跑在森林中的小猫，[推进], 然后 [左摇]",
  "duration": 6,
  "metadata": {
    "prompt_optimizer": true,
    "resolution": "1080P",
    "callback_url": "https://your-server.com/callback"
  }
}

​

💡 开发者建议

1. 异步机制: 本接口是异步的，调用成功仅代表任务创建成功。你需要通过 callback_url 接收推送，或者使用查询接口通过 task_id 获取最终视频链接。
2. 回调验证: 配置 callback_url 后，MiniMax 会发送一个 POST 请求，你需要在 3 秒内原样返回其提供的 challenge 值以完成校验。
3. 分辨率匹配: MiniMax-Hailuo-2.3 和 02 模型对 10s 视频仅支持 768P。