视频任务状态查询

GET /minimax/v1/query/video_generation

MethodGET
Path/minimax/v1/query/video_generation
Typehttp
Status1
Module2102810
Folder62584383

概览

MethodGET
Path/minimax/v1/query/video_generation
Typehttp
Status1
Module2102810
Folder62584383

参数

{
  "query": [
    {
      "required": false,
      "description": "视频生成任务的唯一标识ID\n",
      "type": "string",
      "id": "CP2i1nojJC",
      "enable": true,
      "name": "task_id",
      "sampleValue": "306792606023824"
    }
  ],
  "path": [],
  "header": []
}

请求体

{
  "type": "none",
  "parameters": [],
  "jsonSchema": {
    "type": "object",
    "properties": {
      "user_prompt": {
        "description": "必传,用户输入的提示词/问题描述",
        "type": "string"
      },
      "expand_prompt": {
        "description": "可选,提示词优化开关",
        "type": "boolean"
      },
      "loop": {
        "description": "可选,是否循环使用参考图",
        "type": "boolean"
      },
      "image_url": {
        "description": "可选,参考图片来源",
        "type": "string"
      },
      "image_end_url": {
        "description": "可选,目标关键帧图片",
        "type": "string"
      },
      "notify_hook": {
        "description": "可选,处理完成后的回调通知地址",
        "type": "string"
      }
    },
    "required": [
      "user_prompt",
      "expand_prompt",
      "loop",
      "image_url",
      "image_end_url",
      "notify_hook"
    ],
    "x-apifox-orders": [
      "user_prompt",
      "expand_prompt",
      "loop",
      "image_url",
      "image_end_url",
      "notify_hook"
    ]
  },
  "mediaType": "",
  "examples": [
    {
      "value": "",
      "mediaType": "none",
      "description": ""
    }
  ],
  "oasExtensions": ""
}

响应

[
  {
    "id": 730233867,
    "name": "成功",
    "code": 200,
    "contentType": "json",
    "jsonSchema": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "data": {
          "type": "object",
          "properties": {
            "task_id": {
              "type": "string"
            },
            "action": {
              "type": "string"
            },
            "status": {
              "type": "string"
            },
            "fail_reason": {
              "type": "string"
            },
            "submit_time": {
              "type": "integer"
            },
            "start_time": {
              "type": "integer"
            },
            "finish_time": {
              "type": "integer"
            },
            "progress": {
              "type": "string"
            },
            "data": {
              "type": "object",
              "properties": {
                "file": {
                  "type": "object",
                  "properties": {
                    "bytes": {
                      "type": "integer"
                    },
                    "file_id": {
                      "type": "integer"
                    },
                    "purpose": {
                      "type": "string"
                    },
                    "filename": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "integer"
                    },
                    "download_url": {
                      "type": "string"
                    },
                    "backup_download_url": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "bytes",
                    "file_id",
                    "purpose",
                    "filename",
                    "created_at",
                    "download_url",
                    "backup_download_url"
                  ]
                },
                "status": {
                  "type": "string"
                },
                "file_id": {
                  "type": "string"
                },
                "task_id": {
                  "type": "string"
                },
                "base_resp": {
                  "type": "object",
                  "properties": {
                    "status_msg": {
                      "type": "string"
                    },
                    "status_code": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "status_msg",
                    "status_code"
                  ]
                },
                "video_width": {
                  "type": "integer"
                },
                "video_height": {
                  "type": "integer"
                }
              },
              "required": [
                "file",
                "status",
                "file_id",
                "task_id",
                "base_resp",
                "video_width",
                "video_height"
              ]
            }
          },
          "required": [
            "task_id",
            "action",
            "status",
            "fail_reason",
            "submit_time",
            "start_time",
            "finish_time",
            "progress",
            "data"
          ]
        }
      },
      "required": [
        "code",
        "message",
        "data"
      ]
    },
    "itemSchema": {},
    "description": "",
    "mediaType": "",
    "headers": [],
    "oasExtensions": ""
  }
]

响应示例

[
  {
    "name": "成功示例",
    "responseId": 730233867,
    "data": "{\r\n    \"code\": \"success\",\r\n    \"message\": \"\",\r\n    \"data\": {\r\n        \"task_id\": \"306792606023824\",\r\n        \"action\": \"video_generation\",\r\n        \"status\": \"SUCCESS\",\r\n        \"fail_reason\": \"306793063383292\",\r\n        \"submit_time\": 1756453472,\r\n        \"start_time\": 0,\r\n        \"finish_time\": 1756453535,\r\n        \"progress\": \"100%\",\r\n        \"data\": {\r\n            \"file\": {\r\n                \"bytes\": 0,\r\n                \"file_id\": 306793063383292,\r\n                \"purpose\": \"video_generation\",\r\n                \"filename\": \"output.mp4\",\r\n                \"created_at\": 1756453566,\r\n                \"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\",\r\n                \"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\"\r\n            },\r\n            \"status\": \"Success\",\r\n            \"file_id\": \"306793063383292\",\r\n            \"task_id\": \"306792606023824\",\r\n            \"base_resp\": {\r\n                \"status_msg\": \"success\",\r\n                \"status_code\": 0\r\n            },\r\n            \"video_width\": 1366,\r\n            \"video_height\": 768\r\n        }\r\n    }\r\n}",
    "description": "",
    "oasKey": "",
    "oasExtensions": "",
    "id": 649645388
  }
]