视频生成/MiniMax-H3 创建任务

创建 MiniMax-H3 视频生成任务，了解请求字段、请求示例和响应说明。

MiniMax-H3 创建任务

创建一个异步的 MiniMax-H3 视频生成任务。接口返回任务 ID，之后可通过查询接口获取任务状态和视频结果。

请求地址

项目值
请求方法POST
Base URLhttps://api.unigateway.ai
接口路径/v2/video_generation
完整地址https://api.unigateway.ai/v2/video_generation

请求头

请求头值
AuthorizationBearer <YOUR_UNIGATEWAY_API_KEY>
Content-Typeapplication/json

请求体示例

{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "A red toy car moves slowly across a white tabletop, fixed camera, continuous shot."
    }
  ],
  "resolution": "2K",
  "duration": 4,
  "ratio": "16:9"
}

请求字段

字段类型说明
modelstring模型 ID，使用 MiniMax-H3。
contentarray视频生成的输入内容。示例使用文本提示词。
content[].typestring内容类型，文本提示词使用 text。
content[].textstring描述待生成视频内容的文本提示词。
resolutionstring请求输出的分辨率，示例为 2K。
durationnumber请求生成的视频时长，单位为秒，示例为 4。
ratiostring请求输出的画面比例，示例为 16:9。

示例值不代表全部可选值或支持的参数组合。

成功响应

{
  "task_id": "PUBLIC_TASK_ID"
}

响应字段

字段类型说明
task_idstring已创建的任务 ID，用于查询任务状态和生成结果。

后续操作

保存 task_id，使用以下地址查询任务：

GET https://api.unigateway.ai/v2/query/video_generation/{task_id}

将 {task_id} 替换为创建接口返回的实际值。创建成功表示任务已受理，不表示视频已经生成完成。