视频任务状态查询

查询指定视频生成任务的执行状态与结果信息。

GET https://www.vortapapi.com/v1/minimax/v1/query/video_generation

请求参数

Query 参数

名称	类型	必填	说明
task_id	string	否	视频生成任务的唯一任务 ID。

请求示例

curl -X GET "https://www.vortapapi.com/v1/minimax/v1/query/video_generation?task_id=306792606023824" \
  -H "Authorization: Bearer sk-***"

响应示例

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "306792606023824",
    "action": "video_generation",
    "status": "SUCCESS",
    "fail_reason": "306793063383292",
    "submit_time": 1756453472,
    "start_time": 0,
    "finish_time": 1756453535,
    "progress": "100%",
    "data": {
      "file": {
        "bytes": 0,
        "file_id": 306793063383292,
        "purpose": "video_generation",
        "filename": "output.mp4",
        "created_at": 1756453566,
        "download_url": "https://public-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com/inference_output%2Fvideo%2F2025-08-29%2F454554d4-6485-469b-8eff-f6786bbaff62%2Foutput.mp4?Expires=1756485985&OSSAccessKeyId=LTAI5tAmwsjSaaZVA6cEFAUu&Signature=5DmRk6grPMEwP7rLq0LwJbi633A%3D",
        "backup_download_url": "https://public-cdn-video-data-algeng-us.oss-us-east-1.aliyuncs.com/inference_output%2Fvideo%2F2025-08-29%2F454554d4-6485-469b-8eff-f6786bbaff62%2Foutput.mp4?Expires=1756485985&OSSAccessKeyId=LTAI5tCpJNKCf5EkQHSuL9xg&Signature=ouuhy8toH%2B58BJOIvnM57Iw5zyc%3D"
      },
      "status": "Success",
      "file_id": "306793063383292",
      "task_id": "306792606023824",
      "base_resp": {
        "status_msg": "success",
        "status_code": 0
      },
      "video_width": 1366,
      "video_height": 768
    }
  }
}

响应字段说明

字段	类型	说明
code	string	请求处理结果标识。通常为 success 表示查询成功。
message	string	返回的提示信息；为空字符串表示无额外信息。
data.task_id	string	被查询的视频生成任务 ID。
data.action	string	任务类型，例如 video_generation。
data.status	string	任务状态，例如 SUCCESS。
data.fail_reason	string	失败原因或相关结果标识；当任务成功时可能仍返回该字段。
data.submit_time	integer	任务提交时间，Unix 时间戳。
data.start_time	integer	任务开始处理时间，Unix 时间戳；为 0 时表示未提供或未开始。
data.finish_time	integer	任务完成时间，Unix 时间戳。
data.progress	string	任务进度，例如 100%。
data.data.file	object	生成视频文件信息。
data.data.file.bytes	integer	文件大小，单位为字节。
data.data.file.file_id	integer	文件 ID。
data.data.file.purpose	string	文件用途，例如 video_generation。
data.data.file.filename	string	文件名。
data.data.file.created_at	integer	文件创建时间，Unix 时间戳。
data.data.file.download_url	string	视频文件下载地址。
data.data.file.backup_download_url	string	备用下载地址。
data.data.status	string	下游任务结果状态，例如 Success。
data.data.file_id	string	生成文件的 ID。
data.data.task_id	string	对应的视频生成任务 ID。
data.data.base_resp.status_msg	string	底层响应状态信息。
data.data.base_resp.status_code	integer	底层响应状态码。
data.data.video_width	integer	输出视频宽度，单位为像素。
data.data.video_height	integer	输出视频高度，单位为像素。