查询任务详情

更新时间：2025-08-22

本接口用于查询任务的执行状态和详细信息。

接口限制：

只能查询到最近7天（7*24小时）内的任务。

请求结构

Http

1GET /v2/tasks/{taskId} HTTP/1.1
2connection: keep-alive
3host: vod.bj.baidubce.com
4content-type: application/json
5x-bce-request-id: <bce-request-id>
6x-bce-date: <utc-date-string>
7authorization: <bce-authorization-string>

在线调试

平台提供了 API在线调试平台-示例代码，用于帮助开发者调试接口，平台集成快速检索、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能，简单易用，更多内容请查看API在线调试介绍。

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数	类型	是否必需	参数位置	描述
taskId	string	否	Path参数	任务ID

返回头域

除公共头域，无其它特殊头域。

返回参数

参考 MediaTaskDetail 结构定义。

示例

获取工作流处理的任务详情

请求内容

Http

1GET /v2/tasks/tsk-emdma8t0xrt5js30 HTTP/1.1
2host: vod.bj.baidubce.com
3accept: */*
4connection: keep-alive
5content-type: application/json
6x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
7x-bce-date: 2024-03-24T13:08:44Z
8authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9

返回内容

Http

1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
4Cache-Control: no-cache
5Date: Tue, 24 Mar 2024 13:08:44 GMT
6Content-Type: application/json;charset=UTF-8
7
8{
9    "taskId": "tsk-emdma8t0xrt5js30",
10    "type": "WORKFLOW",
11    "status": "FINISHED",
12    "createTime": "2024-12-04T03:55:56Z",
13    "finishTime": "2024-12-04T03:56:38Z",
14    "mediaWorkflowTaskInfo": {
15        "mediaId": "mda-emcqauvcuyizbfdd",
16        "workflowId": "ekup232yp9xy8ga5t1gp",
17        "startNodeTaskInfo": {
18            "nodeId": "ekupxv40k2ecti4x1kfc",
19            "nodeName": "输入",
20            "status": "SUCCESS"
21        },
22        "transcodeNodeTaskInfos": [
23            {
24                "nodeId": "ehumx1153asih55hjvnf",
25                "nodeName": "video_a_hls",
26                "transcodeTaskInfo": {
27                    "mediaId": "mda-ekwk0jmb1jt91pt5",
28                    "status": "SUCCESS",
29                    "transcodeInput": {
30                        "presetId": "eiymg20ganpbe6gt2pe7"
31                    },
32                    "transcodeOutput": {
33                        "id": "eiymg20ganpbe6gt2pe7",
34                        "url": "http://vod.com/v1/mda-ekwk0jmb1jt91pt5/_output/eiymg20ganpbe6gt2pe7/mda-ekwk0jmb1jt91pt5.m3u8",
35                        "meta": {
36                            "video": {
37                                "durationInSeconds": 19,
38                                "durationInMilliSeconds": 18757,
39                                "sizeInKiloByte": 6495.316406,
40                                "widthInPixel": 720,
41                                "heightInPixel": 1280,
42                                "bitRateInBps": 2836787,
43                                "frameRate": 29,
44                                "gopAlign": false,
45                                "mp4MoovSize": 0
46                            },
47                            "audio": {
48                                "sampleRateInHz": 44100,
49                                "channels": 2
50                            }
51                        }
52                    }
53                }
54            }
55        ],
56        "thumbnailNodeTaskInfos": [
57            {
58                "nodeId": "ekupipkr4q2fh5papunh",
59                "nodeName": "缩略图",
60                "thumbnailTaskInfo": {
61                    "mediaId": "mda-emcqauvcuyizbfdd",
62                    "status": "SUCCESS",
63                    "thumbnailInput": {
64                        "presetId": "ekupyc90cts7ac0kmmn4"
65                    },
66                    "thumbnailOutput": {
67                        "id": "ekupyc90cts7ac0kmmn4",
68                        "urls": [
69                            "http://vod.com/v1/mda-emcqauvcuyizbfdd/_output/ekupyc90cts7ac0kmmn4/mda-emcqauvcuyizbfdd00000000.jpg",
70                            "http://vod.com/v1/mda-emcqauvcuyizbfdd/_output/ekupyc90cts7ac0kmmn4/mda-emcqauvcuyizbfdd00245685.jpg",
71                            "http://vod.com/v1/mda-emcqauvcuyizbfdd/_output/ekupyc90cts7ac0kmmn4/mda-emcqauvcuyizbfdd00491370.jpg",
72                            "http://vod.com/v1/mda-emcqauvcuyizbfdd/_output/ekupyc90cts7ac0kmmn4/mda-emcqauvcuyizbfdd00737056.jpg",
73                            "http://vod.com/v1/mda-emcqauvcuyizbfdd/_output/ekupyc90cts7ac0kmmn4/mda-emcqauvcuyizbfdd00982741.jpg",
74                            "http://vod.com/v1/mda-emcqauvcuyizbfdd/_output/ekupyc90cts7ac0kmmn4/mda-emcqauvcuyizbfdd01228426.jpg",
75                            "http://vod.com/v1/mda-emcqauvcuyizbfdd/_output/ekupyc90cts7ac0kmmn4/mda-emcqauvcuyizbfdd01474111.jpg",
76                            "http://vod.com/v1/mda-emcqauvcuyizbfdd/_output/ekupyc90cts7ac0kmmn4/mda-emcqauvcuyizbfdd01719796.jpg",
77                            "http://vod.com/v1/mda-emcqauvcuyizbfdd/_output/ekupyc90cts7ac0kmmn4/mda-emcqauvcuyizbfdd01965481.jpg"
78                        ]
79                    }
80                }
81            }
82        ],
83        "publishNodeTaskInfo": {
84            "nodeId": "ekupum6pmu7qvi0yhjxs",
85            "nodeName": "发布",
86            "status": "SUCCESS"
87        }
88    }
89}

获取模板处理的任务详情

请求内容

Http

1GET /v2/tasks/tsk-emcriefvt643bsjy HTTP/1.1
2host: vod.bj.baidubce.com
3accept: */*
4connection: keep-alive
5content-type: application/json
6x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
7x-bce-date: 2024-03-24T13:08:44Z
8authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9

返回内容

Http

1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
4Cache-Control: no-cache
5Date: Tue, 24 Mar 2024 13:08:44 GMT
6Content-Type: application/json;charset=UTF-8
7
8{
9    "taskId": "tsk-emcriefvt643bsjy",
10    "type": "PRESET",
11    "status": "FINISHED",
12    "createTime": "2024-12-03T07:20:26Z",
13    "finishTime": "2024-12-03T07:29:58Z",
14    "mediaPresetTaskInfo": {
15        "mediaId": "mda-emcqauvcuyizbfdd",
16        "transcodeTasks": [
17            {
18                "mediaId": "mda-emcqauvcuyizbfdd",
19                "status": "SUCCESS",
20                "transcodeInput": {
21                    "presetId": "eiympb162kbybwscbfg6",
22                    "digitalWatermark": {
23                        "digitalWmTextContent": "1a中/",
24                        "digitalWmAlgVersion": 2,
25                        "digitalWmStrength": 0.5
26                    }
27                },
28                "transcodeOutput": {
29                    "id": "eiympb162kbybwscbfg6",
30                    "url": "http://vod.com/v1/mda-emcqauvcuyizbfdd/_output/eiympb162kbybwscbfg6/mda-emcqauvcuyizbfdd.mp4",
31                    "meta": {
32                        "video": {
33                            "durationInSeconds": 2211,
34                            "durationInMilliSeconds": 2211166,
35                            "sizeInKiloByte": 76893.198242,
36                            "widthInPixel": 640,
37                            "heightInPixel": 360,
38                            "bitRateInBps": 284876,
39                            "frameRate": 25,
40                            "gopAlign": true,
41                            "mp4MoovSize": 1121018
42                        },
43                        "audio": {
44                            "sampleRateInHz": 44100,
45                            "channels": 2
46                        }
47                    },
48                    "digitalWatermark": {
49                        "digitalWmTextContent": "1a中/",
50                        "digitalWmAlgVersion": 2,
51                        "digitalWmStrength": 0.5
52                    }
53                }
54            }
55        ]
56    }
57}

获取视频生成的任务详情

请求内容

Http

1GET /v2/tasks/tsk-emdma8t0xrt5js30 HTTP/1.1
2host: vod.bj.baidubce.com
3accept: */*
4connection: keep-alive
5content-type: application/json
6x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
7x-bce-date: 2024-03-24T13:08:44Z
8authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9

返回内容

Http

1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
4Cache-Control: no-cache
5Date: Tue, 24 Mar 2024 13:08:44 GMT
6Content-Type: application/json;charset=UTF-8
7{
8    "taskId": "tsk-faikc9dmw8m8saic",
9    "type": "VIDEO_GENERATE",
10    "status": "SUCCESS",
11    "createTime": "2025-01-09T02:04:53Z",
12    "finishTime": "2025-01-09T02:06:53Z",
13    "videoGenerateTaskInfo": {
14        "status": "success",
15        "videoGenerateTaskInput": {
16            "type": "图生视频",
17            "imageToVideoRequest": {
18                "model": "V15",
19                "modelV15TaskInput": {
20                    "headtailImages": {
21                        "headImage": {
22                            "imageUrl": "https://test-ss-images.s3.ap-southeast-1.amazonaws.com/tmp/prompt-300k.jpeg"
23                        },
24                        "tailImage": {
25                            "imageUrl": "https://test-ss-images.s3.ap-southeast-1.amazonaws.com/tmp/prompt-300k.jpeg"
26                        }
27                    },
28                    "prompt": "两个人拥抱",
29                    "duration": 4,
30                    "resolution": "720p",
31                    "movementAmplitude": "auto"
32                }
33            }
34        },
35        "videoGenerateTaskOutput": {
36            "mediaBasicInfos": [
37                {
38                    "mediaId": "mda-faimzupjdsztt1mx",
39                    "name": "图生视频_tsk-faikc9dmw8m8saic",
40                    "description": "",
41                    "mediaType": "video",
42                    "banStatus": "NORMAL",
43                    "createTime": "2025-01-09T03:26:12Z",
44                    "categoryId": "system",
45                    "tags": [],
46                    "source": {
47                        "sourceType": "GENERATE",
48                        "sourceUrl": "http://vod.com/v1/mda-faimzupjdsztt1mx/_src/mda-faimzupjdsztt1mx.mp4?authorization=bce-auth-v1%2FALTAKcfr7rzaK44AsMUcaT2dVH%2F2025-01-09T10%3A33%3A01Z%2F3600%2F%2Feef10e12da4fe85f29a726872ec6f68d44e792d278b75221560546914f2ad1d1",
49                        "coverUrl": "http://vod.com/v1/mda-faimzupjdsztt1mx/_output/cover.jpeg?authorization=bce-auth-v1%2FALTAKcfr7rzaK44AsMUcaT2dVH%2F2025-01-09T10%3A33%3A01Z%2F3600%2F%2F6dcc0adceb7f1f6c1d6254a1e0274e0ec48c9daf4227f9a013688d73f8fc839a"
50                    },
51                    "sourceMetadata": {
52                        "fileSizeInByte": 1916539,
53                        "type": "video",
54                        "container": "mov,mp4,m4a,3gp,3g2,mj2",
55                        "durationInSecond": 4,
56                        "durationInMillisecond": 3720,
57                        "video": {
58                            "codec": "h264",
59                            "heightInPixel": 1280,
60                            "widthInPixel": 720,
61                            "bitRateInBps": 4118041,
62                            "frameRate": 32.0
63                        },
64                        "etag": "98c43448a3cb45193e3ba02d60d025b7"
65                    }
66                }
67            ]
68        }
69    }
70}

错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	错误信息	HTTP状态码	描述
MediaTaskNotFound	MediaTask xxx not found	404 Not Found	没有找到对应的任务

查询任务列表

事件回调相关接口

智能点播平台 VOD

智能点播平台 VOD

查询任务详情

请求结构

在线调试

请求头域

请求参数

返回头域

返回参数

示例

获取工作流处理的任务详情

请求内容

返回内容

获取模板处理的任务详情

请求内容

返回内容

获取视频生成的任务详情

请求内容

返回内容

错误码