视频质量检测模板接口 -ag真人官网
更新时间：2021-12-07
创建视频质检模板
接口描述
用户可以通过此接口创建视频质检模板。
请求（request）
-
请求语法：
post /v{version}/preset/video_defect_detect http/1.1 accept-encoding: gzip, deflate x-bce-date: {utc-date-string} connection: keep-alive accept: */* host: media.bj.baidubce.com x-bce-request-id: {bce-request-id} content-type: application/json authorization: {bce-authorization-string} - 请求头域：无特殊header参数
- 请求参数：无
- 请求体：
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| presetname | string | 必选 | 模板名称 | —— | —— |
| description | string | 可选 | 模板描述 | —— | —— |
| interval | number | 可选 | 抽帧间隔（毫秒、ms） | —— | 1000 |
| models | modelsparm | 可选 | 需要检测的项目（使用的模型） | —— | —— |
modelsparm
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| bright | modelparm | 可选 | 亮度检测模型 | —— | —— |
| color | modelparm | 可选 | 色度检测模型 | —— | —— |
| blur | modelparm | 可选 | 模糊检测模型 | —— | —— |
| noise | modelparm | 可选 | 噪声检测模型 | —— | —— |
| mosaic | modelparm | 可选 | 马赛克检测模型 | —— | —— |
| freeze | modelparm | 可选 | 冻结检测模型 | —— | —— |
| jitter | modelparm | 可选 | 抖动检测模型 | —— | —— |
| stripe | modelparm | 可选 | 滚动条纹检测模型 | —— | —— |
| blackedge | modelparm | 可选 | 黑边检测模型 | —— | —— |
modelparm
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| enable | boolean | 可选 | 是否使用该模型 | true、false | true |
| threshold | number | 可选 | 检测阈值, bright/color/blur/noise/mosaic/blackedge模型需要，其他模型不需要 | 0.0~1.0 | bright模型为0.500，color模型为0.300，blur/noise模型为0.400，mosaic模型为0.001，blackedge模型为0.200 |
模型阈值和检测逻辑解释：
| 模型 | 模型描述 | 有无阈值 | 默认阈值 | 阈值含义 | 模型检测逻辑 |
|---|---|---|---|---|---|
| bright | 亮度检测模型 | 有 | 0.500 | 表示检测每帧图像偏亮或偏暗程度（值越大程度越大）的阈值 | 某帧图像的偏亮或偏暗程度大于该阈值则认为该帧存在异常，并写入检测结果中 |
| color | 色度检测模型 | 有 | 0.300 | 表示检测每帧图像偏色（红、黄、绿、蓝、紫）程度（值越大程度越大）的阈值 | 某帧图像的偏色程度大于该阈值则认为该帧存在异常，并写入检测结果中 |
| blur | 模糊检测模型 | 有 | 0.400 | 表示检测每帧图像模糊程度（值越大程度越大）的阈值 | 某帧图像的模糊程度大于该阈值则认为该帧存在异常，并写入检测结果中 |
| noise | 噪声检测模型 | 有 | 0.400 | 表示检测每帧图像噪声程度（值越大程度越大）的阈值 | 某帧图像的噪声程度大于该阈值则认为该帧存在异常，并写入检测结果中 |
| mosaic | 马赛克检测模型 | 有 | 0.001 | 表示检测每帧图像中马赛克区域与整个图像面积比值的阈值 | 某帧图像中马赛克区域与整个图像面积比值大于该阈值则认为该帧存在异常，并写入检测结果中 |
| freeze | 冻结检测模型 | 无 | —— | —— | 当前帧相对前一帧无变化，表示当前帧存在冻结或称为静帧。连续3帧图像存在冻结则认为该帧（连续3帧的最后一帧）存在异常，并写入检测结果中 |
| jitter | 抖动检测模型 | 无 | —— | —— | 在前20帧中发生了整体往复运动，且单向运动幅值均超过5个像素，表示当前帧存在抖动。连续3帧图像存在抖动则认为该帧（连续3帧的最后一帧）存在异常，并写入检测结果中 |
| stripe | 滚动条纹检测模型 | 无 | —— | —— | 当前帧相对前一帧运动条纹的长度大于图像边长（将图像长宽比转为1：1时）的一半，且条纹数量大于3，表示当前帧存在滚动条纹。连续3帧图像存在滚动条纹则认为该帧（连续3帧的最后一帧）存在异常，并写入检测结果中 |
| blackedge | 黑边检测模型 | 有 | 0.200 | 表示检测每帧图像中非黑边（黑边包含黑色、其他纯色和高斯模糊边界）区域与整个图像面积比值的阈值 | 某帧图像中非黑边区域与整个图像面积比值大于该阈值则认为存在该异常，并写入检测结果中 |
-
请求示例
post /v3/preset/video_defect_detect http/1.1 accept-encoding: gzip, deflate x-bce-date: 2021-05-21t21:13:00z host: media.bj.baidubce.com accept: */* connection: keep-alive x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968 content-type: application/json authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2021-05-21t21:13:00z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9 { "presetname": "customlized_video_defect_detect_preset", "description": "an example video_defect_detect preset description", "interval": 1000, "models": { "bright": { "enable": true, "threshold": 0.5 }, "color": { "enable": true, "threshold": 0.6 }, "mosaic": { "enable": true } } }
响应（reponse）
- 响应头域：无特殊header参数
- 响应参数：无
- 响应体：无
-
响应示例：
http/1.1 200 ok transfer-encoding: chunked x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968 cache-control: no-cache server: bws date: tue, 21 may 2021 21:13:02 gmt content-type: application/json;charset=utf-8
查询指定视频质检模板
接口描述
通过presetname查询视频质检模板。
请求（request）
-
请求语法：
get /v{version}/preset/video_defect_detect/{presetname} http/1.1 accept-encoding: gzip, deflate x-bce-date: {utc-date-string} host: media.bj.baidubce.com accept: */* connection: keep-alive x-bce-request-id: {bce-request-id} content-type: application/json authorization: {bce-authorization-string} - 请求头域：无特殊header参数
- 请求参数：
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| presetname | string | 可选 | 模板名称 | —— | —— |
- 请求体：无
-
请求示例：
get /v3/preset/video_defect_detect/customlized_video_defect_detect_preset http/1.1 accept-encoding: gzip, deflate x-bce-date: 2021-05-21t21:21:21z host: media.bj.baidubce.com accept: */* connection: keep-alive x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481 content-type: application/json authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2021-05-21t21:21:21z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
响应（reponse）
- 响应头域：无特殊header参数
- 响应参数：无
- 响应体：与[创建视频质检模板/请求/请求体]保持一致，增加以下字段
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| state | string | 模板状态，active/inactive，分别表示 在用的模板/已删除的模板 |
| presettype | string | 模板类型，system/custom，分别表示 系统内置模板/用户自定义模板 |
| createdtime | string | 模板创建的utc格式的时间 |
-
响应示例：
http/1.1 200 ok transfer-encoding: chunked x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481 cache-control: no-cache server: bws date: tue, 21 may 2021 21:21:21 gmt content-type: application/json;charset=utf-8 { "state": "active", "presettype": "custom", "createdtime": "2021-05-20t21:13:00z", "presetname": "customlized_video_defect_detect_preset", "description": "an example video_defect_detect preset description", "interval": 1000, "models": { "bright": { "enable": true, "threshold": 0.5 }, "color": { "enable": true, "threshold": 0.6 }, "mosaic": { "enable": true } } }
查询当前用户及系统的所有模板
接口描述
用户查询其名下及系统提供的所有的模板，具体有哪些系统模板可以参考系统内置模板。
请求（request）
-
请求语法：
get /v{version}/preset/video_defect_detect http/1.1 accept-encoding: gzip, deflate x-bce-date: {utc-date-string} connection: keep-alive accept: */* host: media.bj.baidubce.com x-bce-request-id: {bce-request-id} content-type: application/json authorization: {bce-authorization-string} - 请求头域：无特殊header参数
- 请求参数：无
- 请求体：无
-
请求示例：
get /v3/preset/video_defect_detect http/1.1 accept-encoding: gzip, deflate x-bce-date: 2021-05-21t21:31:21z host: media.bj.baidubce.com accept: */* connection: keep-alive x-bce-request-id: 3807ce30-5264-45f2-9b52-26b78e24a750 content-type: application/json authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2021-05-21t21:31:21z/1800/host;x-bce-date/3e1bf9f50ae1fca2d704d61567810dde946fff3ca2e455676455a6f5c8cce596
响应（response）
- 响应头域：无特殊header参数
- 响应参数：无
- 响应体：与[创建视频质检模板/请求/请求体]保持一致，增加以下字段
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| presets | list[vddpreset] | 模板列表 |
vddpreset
与[查询指定视频质检模板/响应/响应体]保持一致
- 响应示例：
http/1.1 200 ok
transfer-encoding: chunked
x-bce-request-id: 3807ce30-5264-45f2-9b52-26b78e24a750
cache-control: no-cache
server: bws
date: tue, 24 mar 2021 21:31:21 gmt
content-type: application/json;charset=utf-8
{
"presets": [
{
"state": "active",
"presettype": "custom",
"createdtime": "2021-05-20t21:13:00z",
"presetname": "customlized_video_defect_detect_preset",
"description": "an example video_defect_detect preset description",
"interval": 1000,
"models": {
"bright": {
"enable": true,
"threshold": 0.5
},
"color": {
"enable": true,
"threshold": 0.6
},
"mosaic": {
"enable": true
}
}
},
{
"state": "active",
"presettype": "custom",
"createdtime": "2021-05-20t20:14:00z",
"presetname": "customlized_video_defect_detect_preset2",
"description": "an example video_defect_detect preset description 2",
"interval": 1000,
"models": {
"bright": {
"enable": true,
"threshold": 0.5
}
}
}
]
}更新视频质检模板
接口描述
通过presetname更新视频质检模板。
请求（request）
-
请求语法：
put /v{version}/preset/video_defect_detect/{presetname} http/1.1 accept-encoding: gzip, deflate x-bce-date: {utc-date-string} host: media.bj.baidubce.com accept: */* connection: keep-alive x-bce-request-id: {bce-request-id} content-type: application/json authorization: {bce-authorization-string} - 请求头域：无特殊header参数
- 请求参数：
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| presetname | string | 可选 | 任务的模板名称 | —— | —— |
- 请求体：同[创建视频质检模板/请求/请求体]
-
请求示例：
put /v3/preset/video_defect_detect/customlized_video_defect_detect_preset http/1.1 accept-encoding: gzip, deflate x-bce-date: 2021-05-21t21:31:21z host: media.bj.baidubce.com accept: */* connection: keep-alive x-bce-request-id: 0969b91e-1890-470b-b93b-97939f672e54 content-type: application/json authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2020-02-14t15:12:37z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9 { "presetname": "customlized_video_defect_detect_preset", "description": "an example video_defect_detect preset description", "interval": 1000, "models": { "bright": { "enable": true, "threshold": 0.5, }, "color": { "enable": true, "threshold": 0.5, }, "mosaic": { "enable": true } } }
响应（reponse）
- 响应头域：无特殊header参数
- 响应参数：无
- 响应体：无
-
响应示例：
http/1.1 200 ok transfer-encoding: chunked x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481 cache-control: no-cache server: bws date: tue, 21 may 2021 21:31:22 gmt content-type: application/json;charset=utf-8
删除视频质检模板
接口描述
通过presetname删除视频质检模板。
请求（request）
-
请求语法：
delete /v{version}/preset/video_defect_detect/{presetname} http/1.1 accept-encoding: gzip, deflate x-bce-date: {utc-date-string} host: media.bj.baidubce.com accept: */* connection: keep-alive x-bce-request-id: {bce-request-id} content-type: application/json authorization: {bce-authorization-string} - 请求头域：无特殊header参数
- 请求参数：
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| presetname | string | 可选 | 任务的模板名称 | —— | —— |
- 请求体：无
-
请求示例：
delete /v{version}/preset/video_defect_detect/customlized_video_defect_detect_preset http/1.1 accept-encoding: gzip, deflate x-bce-date: 2021-05-21t21:41:21z host: media.bj.baidubce.com accept: */* connection: keep-alive x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481 content-type: application/json authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2021-05-21t21:21:21z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
响应（reponse）
- 响应头域：无特殊header参数
- 响应参数：无
- 响应体：无
-
响应示例：
http/1.1 200 ok x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e cache-control: no-cache