青云TOP API开发文档开发者文档
控制台
返回模型调用 API 参考
GET/minimax/v1/query/video_generation

视频任务状态查询

API Key none

请求示例

curl https://top.qingyuntop.ai/minimax/v1/query/video_generation \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}"

请求参数

参数位置类型必填说明示例
task_idQuerystring否视频生成任务的唯一标识ID 306792606023824
user_promptJSON bodystring是必传，用户输入的提示词/问题描述-
expand_promptJSON bodyboolean是可选，提示词优化开关-
loopJSON bodyboolean是可选，是否循环使用参考图-
image_urlJSON bodystring是可选，参考图片来源-
image_end_urlJSON bodystring是可选，目标关键帧图片-
notify_hookJSON bodystring是可选，处理完成后的回调通知地址-

返回响应 (200)

参数位置类型必填说明示例
code响应 JSONstring是--
message响应 JSONstring是--
data响应 JSONobject是--
data.task_id响应 JSONstring是--
data.action响应 JSONstring是--
data.status响应 JSONstring是--
data.fail_reason响应 JSONstring是--
data.submit_time响应 JSONinteger是--
data.start_time响应 JSONinteger是--
data.finish_time响应 JSONinteger是--
data.progress响应 JSONstring是--
data.data响应 JSONobject是--
data.data.file响应 JSONobject是--
data.data.file.bytes响应 JSONinteger是--
data.data.file.file_id响应 JSONinteger是--
data.data.file.purpose响应 JSONstring是--
data.data.file.filename响应 JSONstring是--
data.data.file.created_at响应 JSONinteger是--
data.data.file.download_url响应 JSONstring是--
data.data.file.backup_download_url响应 JSONstring是--
data.data.status响应 JSONstring是--
data.data.file_id响应 JSONstring是--
data.data.task_id响应 JSONstring是--
data.data.base_resp响应 JSONobject是--
data.data.base_resp.status_msg响应 JSONstring是--
data.data.base_resp.status_code响应 JSONinteger是--
data.data.video_width响应 JSONinteger是--
data.data.video_height响应 JSONinteger是--

响应示例

{
    "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
        }
    }
}
来源原始接口定义（用于追溯）

以下内容来自 Apifox 快照，可能包含兼容层字段或旧示例；公开调用请以本页的协议说明和当前模型列表为准。

{
  "id": 495899709,
  "name": "视频任务状态查询",
  "type": "http",
  "serverId": "",
  "preProcessors": [],
  "postProcessors": [],
  "inheritPreProcessors": {},
  "inheritPostProcessors": {},
  "description": "",
  "operationId": "",
  "sourceUrl": "",
  "method": "get",
  "path": "/minimax/v1/query/video_generation",
  "tags": [],
  "status": 1,
  "requestBody": {
    "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"
      ]
    },
    "examples": [
      {
        "value": "",
        "mediaType": "none",
        "description": ""
      }
    ],
    "mediaType": "",
    "oasExtensions": "",
    "required": false,
    "additionalContentTypes": []
  },
  "parameters": {
    "path": [],
    "query": [
      {
        "id": "CP2i1nojJC",
        "name": "task_id",
        "required": false,
        "enable": true,
        "description": "视频生成任务的唯一标识ID\n",
        "type": "string",
        "sampleValue": "306792606023824"
      }
    ],
    "cookie": [],
    "header": []
  },
  "commonParameters": {
    "query": [],
    "body": [],
    "cookie": [],
    "header": []
  },
  "auth": {},
  "responses": [
    {
      "id": 103753128,
      "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"
                    ],
                    "x-apifox-orders": [
                      "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"
                    ],
                    "x-apifox-orders": [
                      "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"
                ],
                "x-apifox-orders": [
                  "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"
            ],
            "x-apifox-orders": [
              "task_id",
              "action",
              "status",
              "fail_reason",
              "submit_time",
              "start_time",
              "finish_time",
              "progress",
              "data"
            ]
          }
        },
        "required": [
          "code",
          "message",
          "data"
        ],
        "x-apifox-orders": [
          "code",
          "message",
          "data"
        ]
      },
      "itemSchema": {},
      "description": "",
      "mediaType": "",
      "headers": [],
      "oasExtensions": ""
    }
  ],
  "responseExamples": [
    {
      "name": "成功示例",
      "responseId": 103753128,
      "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": "019fd25e-4dfe-74d0-ba30-b1efd2a353dd"
    }
  ],
  "codeSamples": [],
  "projectId": 8662722,
  "moduleId": 8310462,
  "folderId": 92749337,
  "ordering": 6,
  "responsibleId": 0,
  "commonResponseStatus": {},
  "advancedSettings": {
    "disabledSystemHeaders": {},
    "isDefaultUrlEncoding": 1
  },
  "customApiFields": {},
  "oasExtensions": "",
  "mockScript": {},
  "createdAt": "2026-08-02T03:53:34.000Z",
  "updatedAt": "2026-08-06T12:15:55.000Z",
  "creatorId": 2863449,
  "editorId": 2863449,
  "creatorUserId": 2863449,
  "editorUserId": 2863449,
  "responseChildren": [],
  "visibility": "INHERITED",
  "securityScheme": {},
  "callbacks": ""
}