查询任务详情
更新时间:2025-04-11
本接口用于查询任务的执行状态和详细信息。
接口限制:
- 只能查询到最近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 | 没有找到对应的任务 |