查询任务

文档版本：v1.0.0 | 最后更新：2026-08-13
本平台已完整适配 MiniMax 视频生成 V2（MiniMax-H3）官方接口，请求与响应均为透传，参数语义与官方一致。

按 task_id 查询单个视频生成、视频再生成或 H3-Context-IR 任务的状态与结果。任务成功（status=succeeded）后可从 content 获取产物：视频任务返回 content.url，H3-Context-IR 任务返回 content.prompt。

GET https://platform.shuyanai.com/hailuo/v2/query/video_generation/{task_id}

路径参数

参数	类型	必填	说明
`task_id`	string	是	创建任务时返回的任务 ID

任务刚提交时状态同步可能存在短暂延迟，此时查询结果可能仅包含任务 ID，稍后重试即可获取完整状态。
视频产物下载链接有时效，请及时下载或转存；过期后可重新查询获取新链接。建议在任务完成后 7 天内完成查询与转存。

请求示例

响应示例

视频生成成功：

{
  "task": {
    "id": "424010985738629",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1785125529,
    "updated_at": 1785125946,
    "content": {
      "url": "https://cdn.example.com/h3-generated-2k-output.mp4"
    },
    "resolution": "2K",
    "duration": 5,
    "usage": {
      "total_seconds": 5,
      "input_seconds": 0,
      "output_seconds": 5,
      "input_image_count": 0
    },
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video"
  }
}

任务失败：

{
  "task": {
    "id": "424010985738630",
    "model": "MiniMax-H3",
    "status": "failed",
    "error": {
      "code": "1026",
      "message": "video description contains sensitive content"
    },
    "created_at": 1785125529,
    "updated_at": 1785125700,
    "resolution": "2K",
    "duration": 5,
    "usage": {
      "total_seconds": 0,
      "input_seconds": 0,
      "output_seconds": 0,
      "input_image_count": 0
    },
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video"
  }
}

响应字段（task 对象）

字段	类型	说明
`id`	string	任务 ID
`model`	string	任务使用的模型名称，如 `MiniMax-H3`
`status`	string (enum)	任务状态：`queued`（排队中）/ `running`（运行中）/ `succeeded`（成功）/ `failed`（失败）/ `cancelled`（已取消）
`error`	object	错误信息，仅任务失败时返回：`code`（错误码）、`message`（错误提示）
`created_at`	integer	任务创建时间，Unix 时间戳（秒）
`updated_at`	integer	任务状态更新时间，Unix 时间戳（秒）
`content`	object	任务产物，任务成功后返回（见下）
`resolution`	string	任务产物的分辨率
`duration`	integer	任务产物的时长（秒）
`usage`	object	计费用量（见下）
`ratio`	string	任务产物的宽高比；不适用于当前任务类型时可能返回空字符串
`task_type`	string (enum)	任务类型：`generation`（视频生成）/ `regeneration`（视频再生成）/ `h3_context_ir`（H3-Context-IR）
`modality`	string (enum)	产物模态：视频生成 / 再生成为 `video`；H3-Context-IR 为 `text`

content 字段：

字段	类型	说明
`url`	string	视频产物的限时下载 URL（视频任务）
`prompt`	string	结构化增强提示词（仅 `task_type=h3_context_ir` 且任务成功时返回）

usage 字段（计费依据）：

字段	类型	适用任务	说明
`total_seconds`	integer	视频任务	计费总秒数 = 输入秒数 + 输出秒数
`input_seconds`	integer	视频任务	输入参考视频计费秒数
`output_seconds`	integer	视频任务	输出视频计费秒数
`input_image_count`	integer	视频任务	计费涉及的输入图片数量
`total_tokens`	integer	Context-IR	Token 总数
`prompt_tokens`	integer	Context-IR	输入 Token 数
`completion_tokens`	integer	Context-IR	输出 Token 数

04-查询任务

查询任务#

路径参数#

请求示例#

响应示例#

响应字段（task 对象）#

查询任务

路径参数

请求示例

响应示例

响应字段（task 对象）