提交视频生成任务

文生视频或图生视频。提交后返回 task_id，通过 GET /minimax/v1/query/video_generation 轮询结果。

网站中的模型与调用示例

文生图生视频生成任务

请求参数

{
  "contentType": "application/json",
  "properties": {
    "aigc_watermark": {
      "description": "是否在生成的视频中添加 AIGC 水印",
      "type": "boolean"
    },
    "callback_url": {
      "description": "接收任务状态更新通知的回调 URL。配置后会收到任务状态变更的异步通知（processing/success/failed）",
      "type": "string"
    },
    "duration": {
      "description": "频时长（秒）。可用值：6 或 10（10秒仅支持 768P 分辨率的 Hailuo 系列模型）",
      "type": "integer"
    },
    "fast_pretreatment": {
      "description": "是否缩短 prompt_optimizer 的优化耗时。仅对 MiniMax-Hailuo-2.3 和 MiniMax-Hailuo-02 模型生效",
      "type": "boolean"
    },
    "first_frame_image": {
      "description": "将指定图片作为视频的起始帧。支持公网 URL 或 Base64 编码的 Data URL (data:image/jpeg;base64,...)",
      "type": "string"
    },
    "model": {
      "description": "模型名称。可选值：MiniMax-Hailuo-2.3, MiniMax-Hailuo-02",
      "type": "string"
    },
    "prompt": {
      "description": "视频的文本描述，最大 2000 字符。支持使用 [指令] 语法进行运镜控制，如 [左移], [右移], [推进], [拉远], [上升], [下降], [左摇], [右摇], [上摇], [下摇], [变焦推近], [变焦拉远], [晃动], [跟随], [固定] 等 15 种运镜指令",
      "type": "string"
    },
    "prompt_optimizer": {
      "description": "是否自动优化 prompt。设为 false 可进行更精确的控制",
      "type": "boolean"
    },
    "resolution": {
      "description": "频分辨率。可选值：720P（其他模型默认）, 768P（Hailuo 系列默认）, 1080P（仅支持 6 秒）",
      "type": "string"
    }
  },
  "required": [
    "model",
    "prompt",
    "duration",
    "resolution",
    "prompt_optimizer",
    "fast_pretreatment",
    "callback_url",
    "aigc_watermark",
    "first_frame_image"
  ]
}

请求示例 · 文生图生视频生成任务

{
  "duration": 6,
  "model": "MiniMax-Hailuo-02",
  "prompt": "A man picks up a book [Pedestal up], then reads [Static shot].",
  "resolution": "1080P"
}

请求示例 · 首尾帧生成视频

{
  "aigc_watermark": false,
  "callback_url": "https://your-domain.com/api/video/callback",
  "duration": 6,
  "first_frame_image": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg",
  "last_frame_image": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg",
  "model": "MiniMax-Hailuo-02",
  "prompt": "A little girl grow up [推进].",
  "prompt_optimizer": true,
  "resolution": "1080P"
}

响应示例 · 成功示例

{
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  },
  "task_id": "106916112212032"
}

文生图生视频生成任务

请求参数

{
  "contentType": "application/json",
  "properties": {
    "aigc_watermark": {
      "description": "是否在生成的视频中添加 AIGC 水印",
      "type": "boolean"
    },
    "callback_url": {
      "description": "接收任务状态更新通知的回调 URL。配置后会收到任务状态变更的异步通知（processing/success/failed）",
      "type": "string"
    },
    "duration": {
      "description": "频时长（秒）。可用值：6 或 10（10秒仅支持 768P 分辨率的 Hailuo 系列模型）",
      "type": "integer"
    },
    "fast_pretreatment": {
      "description": "是否缩短 prompt_optimizer 的优化耗时。仅对 MiniMax-Hailuo-2.3 和 MiniMax-Hailuo-02 模型生效",
      "type": "boolean"
    },
    "first_frame_image": {
      "description": "将指定图片作为视频的起始帧。支持公网 URL 或 Base64 编码的 Data URL (data:image/jpeg;base64,...)",
      "type": "string"
    },
    "model": {
      "description": "模型名称。可选值：MiniMax-Hailuo-2.3, MiniMax-Hailuo-02",
      "type": "string"
    },
    "prompt": {
      "description": "视频的文本描述，最大 2000 字符。支持使用 [指令] 语法进行运镜控制，如 [左移], [右移], [推进], [拉远], [上升], [下降], [左摇], [右摇], [上摇], [下摇], [变焦推近], [变焦拉远], [晃动], [跟随], [固定] 等 15 种运镜指令",
      "type": "string"
    },
    "prompt_optimizer": {
      "description": "是否自动优化 prompt。设为 false 可进行更精确的控制",
      "type": "boolean"
    },
    "resolution": {
      "description": "频分辨率。可选值：720P（其他模型默认）, 768P（Hailuo 系列默认）, 1080P（仅支持 6 秒）",
      "type": "string"
    }
  },
  "required": [
    "model",
    "prompt",
    "duration",
    "resolution",
    "prompt_optimizer",
    "fast_pretreatment",
    "callback_url",
    "aigc_watermark",
    "first_frame_image"
  ]
}

请求示例 · 文生图生视频生成任务

{
  "duration": 6,
  "model": "MiniMax-Hailuo-02",
  "prompt": "A man picks up a book [Pedestal up], then reads [Static shot].",
  "resolution": "1080P"
}

请求示例 · 首尾帧生成视频

{
  "aigc_watermark": false,
  "callback_url": "https://your-domain.com/api/video/callback",
  "duration": 6,
  "first_frame_image": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg",
  "last_frame_image": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg",
  "model": "MiniMax-Hailuo-02",
  "prompt": "A little girl grow up [推进].",
  "prompt_optimizer": true,
  "resolution": "1080P"
}

响应示例 · 成功示例

{
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  },
  "task_id": "106916112212032"
}

文生图生视频生成任务

请求参数

{
  "contentType": "application/json",
  "properties": {
    "aigc_watermark": {
      "description": "是否在生成的视频中添加 AIGC 水印",
      "type": "boolean"
    },
    "callback_url": {
      "description": "接收任务状态更新通知的回调 URL。配置后会收到任务状态变更的异步通知（processing/success/failed）",
      "type": "string"
    },
    "duration": {
      "description": "频时长（秒）。可用值：6 或 10（10秒仅支持 768P 分辨率的 Hailuo 系列模型）",
      "type": "integer"
    },
    "fast_pretreatment": {
      "description": "是否缩短 prompt_optimizer 的优化耗时。仅对 MiniMax-Hailuo-2.3 和 MiniMax-Hailuo-02 模型生效",
      "type": "boolean"
    },
    "first_frame_image": {
      "description": "将指定图片作为视频的起始帧。支持公网 URL 或 Base64 编码的 Data URL (data:image/jpeg;base64,...)",
      "type": "string"
    },
    "model": {
      "description": "模型名称。可选值：MiniMax-Hailuo-2.3, MiniMax-Hailuo-02",
      "type": "string"
    },
    "prompt": {
      "description": "视频的文本描述，最大 2000 字符。支持使用 [指令] 语法进行运镜控制，如 [左移], [右移], [推进], [拉远], [上升], [下降], [左摇], [右摇], [上摇], [下摇], [变焦推近], [变焦拉远], [晃动], [跟随], [固定] 等 15 种运镜指令",
      "type": "string"
    },
    "prompt_optimizer": {
      "description": "是否自动优化 prompt。设为 false 可进行更精确的控制",
      "type": "boolean"
    },
    "resolution": {
      "description": "频分辨率。可选值：720P（其他模型默认）, 768P（Hailuo 系列默认）, 1080P（仅支持 6 秒）",
      "type": "string"
    }
  },
  "required": [
    "model",
    "prompt",
    "duration",
    "resolution",
    "prompt_optimizer",
    "fast_pretreatment",
    "callback_url",
    "aigc_watermark",
    "first_frame_image"
  ]
}

请求示例 · 文生图生视频生成任务

{
  "duration": 6,
  "model": "MiniMax-Hailuo-02",
  "prompt": "A man picks up a book [Pedestal up], then reads [Static shot].",
  "resolution": "1080P"
}

请求示例 · 首尾帧生成视频

{
  "aigc_watermark": false,
  "callback_url": "https://your-domain.com/api/video/callback",
  "duration": 6,
  "first_frame_image": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg",
  "last_frame_image": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg",
  "model": "MiniMax-Hailuo-02",
  "prompt": "A little girl grow up [推进].",
  "prompt_optimizer": true,
  "resolution": "1080P"
}

响应示例 · 成功示例

{
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  },
  "task_id": "106916112212032"
}

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

网站中的模型与调用示例

文生图生视频生成任务

请求参数

请求示例 · 文生图生视频生成任务

请求示例 · 首尾帧生成视频

响应示例 · 成功示例

文生图生视频生成任务

请求参数

请求示例 · 文生图生视频生成任务

请求示例 · 首尾帧生成视频

响应示例 · 成功示例

文生图生视频生成任务

请求参数

请求示例 · 文生图生视频生成任务

请求示例 · 首尾帧生成视频

响应示例 · 成功示例

请求参数

请求示例代码

返回响应

提交视频生成任务

网站中的模型与调用示例#

文生图生视频生成任务#

请求参数#

请求示例 · 文生图生视频生成任务#

请求示例 · 首尾帧生成视频#

响应示例 · 成功示例#

文生图生视频生成任务#

请求参数#

请求示例 · 文生图生视频生成任务#

请求示例 · 首尾帧生成视频#

响应示例 · 成功示例#

文生图生视频生成任务#

请求参数#

请求示例 · 文生图生视频生成任务#

请求示例 · 首尾帧生成视频#

响应示例 · 成功示例#

请求参数

请求示例代码

返回响应

网站中的模型与调用示例

文生图生视频生成任务

请求参数

请求示例 · 文生图生视频生成任务

请求示例 · 首尾帧生成视频

响应示例 · 成功示例

文生图生视频生成任务

请求参数

请求示例 · 文生图生视频生成任务

请求示例 · 首尾帧生成视频

响应示例 · 成功示例

文生图生视频生成任务

请求参数

请求示例 · 文生图生视频生成任务

请求示例 · 首尾帧生成视频

响应示例 · 成功示例