视频质量检测任务接口

创建视频质检任务

接口描述

用户通过BOS Bucket、Key以及其他配置信息为指定视频做质量检测。

请求（Request）

• 请求语法：

  Http 复制

  1POST /v{version}/job/video_defect_detect HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: {utc-date-string}
  4connection: keep-alive
  5accept: */*
  6host: media.bj.baidubce.com
  7x-bce-request-id: {bce-request-id}
  8content-type: application/json
  9authorization: {bce-authorization-string}

• 请求头域：无特殊Header参数
• 请求参数：无
• 请求体：

ModelsParm

ModelParm

各模型threshold阈值含义

• 请求示例

  Http 复制

  1POST /v3/job/video_defect_detect HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: 2021-05-21T21:13:00Z
  4host: media.bj.baidubce.com
  5accept: */*
  6connection: keep-alive
  7x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
  8content-type: application/json
  9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2021-05-21T21:13:00Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
  10
  11{
  12    "pipelineName": "high_priority_pipe",
  13    "source": {
  14        "key": "samplefolderpath/samplevideo.mp4"
  15    },
  16    "needTarget": true,
  17    "target": {
  18        "targetFolder": "sampleoutputfolderpath"
  19    },
  20    "models": {
  21        "tooBright": {
  22            "enable": true,
  23            "interval": 1000,
  24            "threshold": 0.5,
  25            "duration": 2000
  26        },
  27        "reddish": {
  28            "enable": true,
  29            "interval": 1000,
  30            "threshold": 0.6,
  31            "duration": 2000
  32        },
  33        "mosaic": {
  34            "enable": true,
  35            "interval": 1000,
  36            "duration": 2000
  37        }
  38    }
  39}

响应（Reponse）

• 响应头域：无特殊Header参数
• 响应参数：无
• 响应体：

• 响应示例：

  Http 复制

  1HTTP/1.1 200 OK
  2Transfer-Encoding: chunked
  3x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
  4Cache-Control: no-cache
  5Server: BWS
  6Date: Tue, 21 May 2021 21:13:02 GMT
  7Content-Type: application/json;charset=UTF-8
  8
  9{
  10    "jobId":"job-lsdspxdastsmnbam"
  11}

查询指定视频质检任务

接口描述

通过jobId查询视频质检任务。

请求（Request）

• 请求语法：

  Http 复制

  1GET /v{version}/job/video_defect_detect/{jobId} HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: {utc-date-string}
  4host: media.bj.baidubce.com
  5accept: */*
  6connection: keep-alive
  7x-bce-request-id: {bce-request-id}
  8content-type: application/json
  9authorization: {bce-authorization-string}

• 请求头域：无特殊Header参数
• 请求参数：

• 请求体：无

• 请求示例：

  Http 复制

  1GET /v3/job/video_defect_detect/job-lsdspxdastsmnbam HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: 2021-05-21T21:21:21Z
  4host: media.bj.baidubce.com
  5accept: */*
  6connection: keep-alive
  7x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
  8content-type: application/json
  9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2021-05-21T21:21:21Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9

响应（Reponse）

• 响应头域：无特殊Header参数
• 响应参数：无
• 响应体：与[创建视频质检任务/请求/请求体]保持一致，增加以下字段

ModelsResult

ModelResult

DefectResult

• 响应示例：

  Http 复制

  1HTTP/1.1 200 OK
  2Transfer-Encoding: chunked
  3x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
  4Cache-Control: no-cache
  5Server: BWS
  6Date: Tue, 21 May 2021 21:21:21 GMT
  7Content-Type: application/json;charset=UTF-8
  8
  9{
  10    "jobId": "job-lsdspxdastsmnbwx",
  11    "jobStatus": "success",
  12    "pipelineName": "high_priority_pipe",
  13    "source": {
  14        "key": "samplefolderpath/samplevideo.mp4"
  15    },
  16    "needTarget": true,
  17    "target": {
  18        "targetFolder": "sampleoutputfolderpath"
  19    },
  20    "usedTime": 12000,
  21    "result": {
  22        "tooBright": {
  23            "success": true,
  24            "defects": [
  25                {
  26                    "score": 0.95,
  27                    "start": 4000,
  28                    "end": 5000,
  29                    "targetKeys": [
  30                        "sampleoutputfolderpath/00004000.jpg",
  31                        "sampleoutputfolderpath/00005000.jpg"
  32                    ]
  33                }
  34            ]
  35        },
  36        "reddish": {
  37            "success": true,
  38            "defects": [
  39                {
  40                    "score": 0.95,
  41                    "start": 9000,
  42                    "end": 10000,
  43                    "targetKeys": [
  44                        "sampleoutputfolderpath/00009000.jpg",
  45                        "sampleoutputfolderpath/00010000.jpg"
  46                    ]
  47                }
  48            ]
  49        },
  50        "mosaic": {
  51            "success": true,
  52            "defects": [
  53                {
  54                    "start": 16000,
  55                    "end": 17000,
  56                    "targetKeys": [
  57                        "sampleoutputfolderpath/00016000.jpg",
  58                        "sampleoutputfolderpath/00017000.jpg"
  59                    ]
  60                },
  61                {
  62                    "start": 19000,
  63                    "end": 20000,
  64                    "targetKeys": [
  65                        "sampleoutputfolderpath/00019000.jpg",
  66                        "sampleoutputfolderpath/00020000.jpg"
  67                    ]
  68                }
  69            ]
  70        }
  71    },
  72    "createTime": "2021-05-20T21:13:00Z",
  73    "startTime" : "2021-05-20T21:13:01Z",
  74    "endTime": "2021-05-20T21:13:14Z"
  75}

查询指定队列的视频质检任务

接口描述

查询指定队列下满足一定条件的所有质检任务。

请求（Request）

• 请求语法：

  Http 复制

  1GET /v{version}/job/video_defect_detect?pipelineName={pipelineName}&jobStatus={jobStatus}&begin={begin}&end={end}}&marker={marker}&maxSize={maxSize} HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: {utc-date-string}
  4host: media.bj.baidubce.com
  5accept: */*
  6connection: keep-alive
  7x-bce-request-id: {bce-request-id}
  8content-type: application/json
  9authorization: {bce-authorization-string}

• 请求头域：无特殊Header参数
• 请求参数：

• 请求体：无

• 请求示例：

  Http 复制

  1GET /v3/job/video_defect_detect?pipelineName=high_priority_pipe&jobStatus=SUCCESS&begin=2021-05-20T08%3A53%3A42Z&end=2021-05-22T08%3A53%3A42Z&marker=job-feumm9etdd5c9gqv&maxSize=2 HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: 2021-05-21T21:14:00Z
  4host: media.bj.baidubce.com
  5accept: */*
  6connection: keep-alive
  7x-bce-request-id: 3807ce30-5264-45f2-9b52-26b78e24a750
  8content-type: application/json
  9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2021-05-21T21:14:00Z/1800/host;x-bce-date/3e1bf9f50ae1fca2d704d61567810dde946fff3ca2e455676455a6f5c8cce596

响应（Response）

• 响应头域：无特殊Header参数
• 响应参数：无
• 响应体：与[查询指定视频质检任务/响应/响应体]保持一致，增加以下字段

• 响应示例：

  Http 复制

  1HTTP/1.1 200 OK
  2Transfer-Encoding: chunked
  3x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
  4Cache-Control: no-cache
  5Server: BWS
  6Date: Tue, 21 May 2021 21:21:21 GMT
  7Content-Type: application/json;charset=UTF-8
  8
  9{
  10    "jobs" : [
  11        {
  12            "jobId": "job-lsdspxdastsmnbwx",
  13            "jobStatus": "success",
  14            "pipelineName": "high_priority_pipe",
  15            "source": {
  16                "key": "samplefolderpath/samplevideo.mp4"
  17            },
  18            "needTarget": true,
  19            "target": {
  20                "targetFolder": "sampleoutputfolderpath"
  21            },
  22            "usedTime": 12000,
  23            "result": {
  24                "tooBright": {
  25                    "success": true,
  26                    "defects": [
  27                        {
  28                            "score": 0.95,
  29                            "start": 4000,
  30                            "end": 5000,
  31                            "targetKeys": [
  32                                "sampleoutputfolderpath/00004000.jpg",
  33                                "sampleoutputfolderpath/00005000.jpg"
  34                            ]
  35                        }
  36                    ]
  37                },
  38                "reddish": {
  39                    "success": true,
  40                    "defects": [
  41                        {
  42                            "score": 0.95,
  43                            "start": 9000,
  44                            "end": 10000,
  45                            "targetKeys": [
  46                                "sampleoutputfolderpath/00009000.jpg",
  47                                "sampleoutputfolderpath/00010000.jpg"
  48                            ]
  49                        }
  50                    ]
  51                },
  52                "mosaic": {
  53                    "success": true,
  54                    "defects": [
  55                        {
  56                            "start": 16000,
  57                            "end": 17000,
  58                            "targetKeys": [
  59                                "sampleoutputfolderpath/00016000.jpg",
  60                                "sampleoutputfolderpath/00017000.jpg"
  61                            ]
  62                        },
  63                        {
  64                            "start": 19000,
  65                            "end": 20000,
  66                            "targetKeys": [
  67                                "sampleoutputfolderpath/00019000.jpg",
  68                                "sampleoutputfolderpath/00020000.jpg"
  69                            ]
  70                        }
  71                    ]
  72                }
  73            },
  74            "createTime": "2021-05-20T21:13:00Z",
  75            "startTime" : "2021-05-20T21:13:01Z",
  76            "endTime": "2021-05-20T21:13:14Z"
  77        },
  78        {
  79            "jobId": "job-feumm9etdd5c9gqv",
  80            "jobStatus": "success",
  81            "pipelineName": "high_priority_pipe",
  82            "source": {
  83                "key": "samplefolderpath/samplevideo2.mp4"
  84            },
  85            "needTarget": true,
  86            "target": {
  87                "targetFolder": "sampleoutputfolderpath"
  88            },
  89            "usedTime": 12000,
  90            "result": {
  91                "tooBright": {
  92                    "success": true,
  93                    "defects": [
  94                        {
  95                            "score": 0.95,
  96                            "start": 11000,
  97                            "end": 12000,
  98                            "targetKeys": [
  99                                "sampleoutputfolderpath/00011000.jpg",
  100                                "sampleoutputfolderpath/00012000.jpg"
  101                            ]
  102                        }
  103                    ]
  104                }
  105            },
  106            "createTime": "2021-05-20T21:14:00Z",
  107            "startTime" : "2021-05-20T21:14:01Z",
  108            "endTime": "2021-05-20T21:14:14Z"
  109        }
  110    ],
  111    "marker": "job-lsdspxdastsmnbwx",
  112    "isTruncated": true,
  113    "nextMarker": "job-gfpj59idrpygsjtw"
  114}

重新运行指定视频质检任务

接口描述

通过jobId和presetName重新运行视频质检任务（任务状态需要为成功或失败）。

请求（Request）

• 请求语法：

  Http 复制

  1PUT /v{version}/job/video_defect_detect/{jobId}?rerun&presetName={presetName} HTTP/1.1
  2accept-encoding: gzip, deflate
  3x-bce-date: {utc-date-string}
  4connection: keep-alive
  5accept: */*
  6host: media.bj.baidubce.com
  7x-bce-request-id: {bce-request-id}
  8content-type: application/json
  9authorization: {bce-authorization-string}

• 请求头域：无特殊Header参数
• 请求参数：

• 请求体：无
• 请求示例

1    PUT /v3/job/video_defect_detect/job-lsdspxdastsmnbam?rerun&presetName=customlized_video_defect_detect_preset HTTP/1.1
2    accept-encoding: gzip, deflate
3    x-bce-date: 2021-05-28T21:21:21Z
4    host: media.bj.baidubce.com
5    accept: */*
6    connection: keep-alive
7    x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
8    content-type: application/json
9    authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2021-05-28T21:21:21Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9

响应（Reponse）

• 响应头域：无特殊Header参数
• 响应参数：无
• 响应体：无

• 响应示例：

  Http 复制

  1HTTP/1.1 200 OK
  2Transfer-Encoding: chunked
  3x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
  4Cache-Control: no-cache
  5Server: BWS
  6Date: Tue, 28 May 2021 21:21:21 GMT
  7Content-Type: application/json;charset=UTF-8