查询 MiniMax-H3 视频生成任务，获取任务状态、视频结果与用量信息。

MiniMax-H3 查询任务

查询 MiniMax-H3 视频生成任务的状态、生成参数、输出内容和用量信息。

请求地址

项目	值
请求方法	`GET`
Base URL	`https://api.unigateway.ai`
接口路径	`/v2/query/video_generation/{task_id}`
完整地址	`https://api.unigateway.ai/v2/query/video_generation/{task_id}`

将 {task_id} 替换为创建任务接口返回的实际任务 ID。任务 ID 放在 URL 路径中，本接口无需请求体。

请求头

请求头	值
`Authorization`	`Bearer <YOUR_UNIGATEWAY_API_KEY>`

路径参数

参数	类型	必填	说明
`task_id`	string	是	创建任务响应中的任务 ID。

成功响应示例

以下展示任务生成成功后的响应结构，其中任务 ID 和视频 URL 为示例占位值。

{
  "task": {
    "content": {
      "url": "https://example.com/generated-video.mp4"
    },
    "created_at": 1793454826,
    "duration": 4,
    "estimated_remaining_seconds": 0,
    "id": "PUBLIC_TASK_ID",
    "lecture_video": false,
    "modality": "video",
    "model": "MiniMax-H3",
    "ratio": "16:9",
    "resolution": "2K",
    "status": "succeeded",
    "task_type": "generation",
    "title": "红色玩具车在白色桌面上缓慢行驶",
    "updated_at": 1793454883,
    "usage": {
      "input_image_count": 0,
      "input_seconds": 0,
      "output_seconds": 4,
      "total_seconds": 4
    }
  }
}

响应字段

字段	类型	说明
`task`	object	任务详情。
`task.id`	string	任务 ID。
`task.status`	string	当前任务状态，`succeeded` 表示生成成功。
`task.content`	object	任务返回的输出内容。
`task.content.url`	string	生成视频的 URL，结果可用时返回。
`task.created_at`	number	任务创建时间，Unix 时间戳，单位为秒。
`task.updated_at`	number	任务更新时间，Unix 时间戳，单位为秒。
`task.duration`	number	视频时长，单位为秒。
`task.estimated_remaining_seconds`	number	预计剩余生成时间，单位为秒。
`task.lecture_video`	boolean	上游返回的 `lecture_video` 标记，示例为 `false`。
`task.modality`	string	任务模态，示例为 `video`。
`task.model`	string	本次任务使用的模型。
`task.ratio`	string	视频画面比例。
`task.resolution`	string	视频分辨率。
`task.task_type`	string	任务类型，示例为 `generation`。
`task.title`	string	任务标题。
`task.usage`	object	任务返回的用量信息。
`task.usage.input_image_count`	number	输入图片数量。
`task.usage.input_seconds`	number	输入时长，单位为秒。
`task.usage.output_seconds`	number	输出时长，单位为秒。
`task.usage.total_seconds`	number	任务返回的总用量时长，单位为秒。

结果处理

根据 task.status 判断任务状态，HTTP 200 仅表示查询请求成功，不代表视频已生成完成。
当 task.status 为 succeeded 且 task.content.url 非空时，获取生成的视频。
读取 task.usage 下的字段查看任务用量。
保留结果 URL 的完整签名参数，并在链接过期前保存需要的视频。

示例展示的是生成成功后的最终响应。任务生成过程中，输出内容和用量字段可能尚未返回。

MiniMax-H3 查询任务#

请求地址#

请求头#

路径参数#

成功响应示例#

响应字段#

结果处理#