视频任务状态查询
GET /minimax/v1/query/video_generation
概览
| Method | GET |
|---|---|
| Path | /minimax/v1/query/video_generation |
| Type | http |
| Status | 1 |
| Module | 2102810 |
| Folder | 62584383 |
参数
{ "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 } ]