视频质量检测模板接口

更新时间：2025-08-21

创建视频质检模板

接口描述

用户可以通过此接口创建视频质检模板。

请求（Request）

请求语法：

Http

1POST /v{version}/preset/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参数
请求参数：无
请求体：

字段名称	字段类型	必要性	字段描述	可选值	默认值
presetName	String	必选	模板名称	-	-
description	String	可选	模板描述	-	-
models	ModelsParm	可选	需要检测的项目（使用的模型）	-	-

ModelsParm

字段名称	字段类型	必要性	字段描述	可选值	默认值
whiteScreen	ModelParm	可选	白屏检测模型	-	-
blackScreen	ModelParm	可选	黑屏检测模型	-	-
tooBright	ModelParm	可选	过亮检测模型	-	-
tooDark	ModelParm	可选	过暗检测模型	-	-
redScreen	ModelParm	可选	红屏检测模型	-	-
yellowScreen	ModelParm	可选	黄屏检测模型	-	-
greenScreen	ModelParm	可选	绿屏检测模型	-	-
blueScreen	ModelParm	可选	蓝屏检测模型	-	-
purpleScreen	ModelParm	可选	紫屏检测模型	-	-
reddish	ModelParm	可选	偏红检测模型	-	-
yellowish	ModelParm	可选	偏黄检测模型	-	-
greenish	ModelParm	可选	偏绿检测模型	-	-
bluish	ModelParm	可选	偏蓝检测模型	-	-
purplish	ModelParm	可选	偏紫检测模型	-	-
blur	ModelParm	可选	模糊检测模型	-	-
noise	ModelParm	可选	噪声检测模型	-	-
mosaic	ModelParm	可选	马赛克检测模型	-	-
freeze	ModelParm	可选	冻结检测模型	-	-
jitter	ModelParm	可选	抖动检测模型	-	-
blackEdge	ModelParm	可选	黑边检测模型	-	-
blurEdge	ModelParm	可选	模糊边缘检测模型	-	-
staticEdge	ModelParm	可选	静态边缘检测模型	-	-
crash	ModelParm	可选	花屏检测模型	-	-
colorBar	ModelParm	可选	彩条检测模型	-	-
block	ModelParm	可选	块效应检测模型	-	-
interlace	ModelParm	可选	场效应检测模型	-	-
mute	ModelParm	可选	静音检测模型	-	-
volumeLow	ModelParm	可选	音量过低检测模型	-	-
volumeHigh	ModelParm	可选	音量过高检测模型	-	-
soundIntermittent	ModelParm	可选	声音间断检测模型	-	-

ModelParm

字段名称	字段类型	必要性	字段描述	可选值	默认值
enable	Boolean	可选	是否使用该模型	true、false	true
interval	Number	可选	检测间隔（毫秒）	正整数	jitter模型为200，mute/volumeLow/volumeHigh/soundIntermittent模型为100，其他模型均为1000
threshold	Number	可选	检测分值的阈值, 对应单帧分值>=threshold时，认为单帧异常。tooBright/tooDark/reddish/yellowish/greenish/bluish/purplish/blur/noise/mosaic/blackEdge/blurEdge/staticEdge/block/volumeLow/volumeHigh/soundIntermittent模型支持阈值自定义，其他模型不支持	0.0~1.0	tooBright/tooDark/blur/noise/reddish/yellowish/greenish/bluish/purplish模型为0.5，mosaic模型为0.001，blackEdge/blurEdge/staticEdge模型为0.2, block模型为0.4, mute/soundIntermittent模型为0.0001, volumeLow模型为0.01, volumeHigh模型为0.6
duration	Number	可选	持续时长（毫秒）的阈值, 对应单帧异常持续时长>=duration时，将对应异常时间段写入检测结果中。	非负整数	blur/noise/freeze/volumeLow模型为2000，soundIntermittent模型为100，volumeHigh模型为200，其他模型均为1000

各模型threshold阈值含义

模型	模型描述	默认阈值	阈值含义
whiteScreen	白屏检测模型	-	-
blackScreen	黑屏检测模型	-	-
tooBright	过亮检测模型	0.500	表示检测每帧图像过亮程度（值越大程度越大）的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，阈值越大，表示检测门槛越高。
tooDark	过暗检测模型	0.500	表示检测每帧图像过暗程度（值越大程度越大）的阈值，大于阈值认为单帧存在该异常；支持阈值自定义，阈值越大，表示检测门槛越高。
redScreen	红屏检测模型	-	-
yellowScreen	黄屏检测模型	-	-
greenScreen	绿屏检测模型	-	-
blueScreen	蓝屏检测模型	-	-
purpleScreen	紫屏检测模型	-	-
reddish	偏红检测模型	0.500	表示检测每帧图像偏红程度（值越大程度越大）的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
yellowish	偏黄检测模型	0.500	表示检测每帧图像偏黄程度（值越大程度越大）的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
greenish	偏绿检测模型	0.500	表示检测每帧图像偏绿程度（值越大程度越大）的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
bluish	偏蓝检测模型	0.500	表示检测每帧图像偏蓝程度（值越大程度越大）的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
purplish	偏紫检测模型	0.500	表示检测每帧图像偏紫程度（值越大程度越大）的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
blur	模糊检测模型	0.500	表示检测每帧图像模糊程度（值越大程度越大）的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
noise	噪声检测模型	0.500	表示检测每帧图像噪声程度（值越大程度越大）的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
mosaic	马赛克检测模型	0.001	表示检测每帧图像中马赛克区域与整个图像面积比值的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
freeze	冻结检测模型	-	-
jitter	抖动检测模型	-	-
blackEdge	黑边检测模型	0.200	表示检测每帧图像中黑边区域与整个图像面积比值的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
blurEdge	模糊边缘检测模型	0.200	表示检测每帧图像中模糊边缘区域与整个图像面积比值的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
staticEdge	静态边缘检测模型	0.200	表示检测每帧图像中静态边缘区域与整个图像面积比值的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
crash	花屏检测模型	-	-
colorBar	彩条检测模型	-	-
block	块效应检测模型	0.400	表示检测每帧图像块效应程度（值越大程度越大）的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
interlace	场效应检测模型	-	-
mute	静音检测模型	0.0001	表示检测的每帧音频的音量均值的阈值，小于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
volumeLow	音量过低检测模型	0.001	表示检测的每帧音频的音量均值的阈值，小于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
volumeHigh	音量过高检测模型	0.600	表示检测的每帧音频的音量均值的阈值，大于阈值认为单帧存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。
soundIntermittent	声音间断检测模型	0.0001	表示检测的每帧音频的音量均值的阈值，小于阈值认为单帧存在静音，5秒内出现两次及以上静音，则认为存在该异常；支持阈值自定义[0,1]，设定阈值越大，表示检测门槛越高。

请求示例

Http

1POST /v3/preset/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    "presetName": "customlized_video_defect_detect_preset",
13    "description": "An example video_defect_detect preset description",
14    "models": {
15        "tooBright": {
16            "enable": true,
17            "interval": 1000,
18            "threshold": 0.5,
19            "duration": 2000
20        },
21        "reddish": {
22            "enable": true,
23            "interval": 1000,
24            "threshold": 0.6,
25            "duration": 2000
26        },
27        "mosaic": {
28            "enable": true,
29            "interval": 1000,
30            "duration": 2000
31        }
32    }
33}

响应（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

查询指定视频质检模板

接口描述

通过presetName查询视频质检模板。

请求（Request）

请求语法：

Http

1GET /v{version}/preset/video_defect_detect/{presetName} 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参数
请求参数：

字段名称	字段类型	必要性	字段描述	可选值	默认值
presetName	String	可选	模板名称	-	-

请求体：无

请求示例：

Http

1GET /v3/preset/video_defect_detect/customlized_video_defect_detect_preset 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参数
响应参数：无
响应体：与[创建视频质检模板/请求/请求体]保持一致，增加以下字段

字段名称	字段类型	字段描述
state	String	模板状态，ACTIVE/INACTIVE，分别表示在用的模板/已删除的模板
presetType	String	模板类型，SYSTEM/CUSTOM，分别表示系统内置模板/用户自定义模板
createTime	String	模板创建的UTC格式的时间

响应示例：

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    "state": "ACTIVE",
11    "presetType": "CUSTOM",
12    "createTime": "2021-05-20T21:13:00Z",
13    "presetName": "customlized_video_defect_detect_preset",
14    "description": "An example video_defect_detect preset description",
15    "models": {
16        "tooBright": {
17            "enable": true,
18            "interval": 1000,
19            "threshold": 0.5,
20            "duration": 2000
21        },
22        "reddish": {
23            "enable": true,
24            "interval": 1000,
25            "threshold": 0.6,
26            "duration": 2000
27        },
28        "mosaic": {
29            "enable": true,
30            "interval": 1000,
31            "duration": 2000
32        }
33    }
34}

查询当前用户及系统的所有模板

接口描述

用户查询其名下及系统提供的所有的模板，具体有哪些系统模板可以参考系统内置模板。

请求（Request）

请求语法：

Http

1GET /v{version}/preset/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参数
请求参数：无
请求体：无

请求示例：

Http

1GET /v3/preset/video_defect_detect HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: 2021-05-21T21:31:21Z
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:31:21Z/1800/host;x-bce-date/3e1bf9f50ae1fca2d704d61567810dde946fff3ca2e455676455a6f5c8cce596

响应（Response）

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

字段名称	字段类型	字段描述
presets	List[VddPreset]	模板列表

VddPreset

与[查询指定视频质检模板/响应/响应体]保持一致

响应示例：

Http

1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 3807ce30-5264-45f2-9b52-26b78e24a750
4Cache-Control: no-cache
5Server: BWS
6Date: Tue, 24 Mar 2021 21:31:21 GMT
7Content-Type: application/json;charset=UTF-8
8
9{
10    "presets": [
11        {
12            "state": "ACTIVE",
13            "presetType": "CUSTOM",
14            "createTime": "2021-05-20T21:13:00Z",
15            "presetName": "customlized_video_defect_detect_preset",
16            "description": "An example video_defect_detect preset description",
17            "models": {
18                "tooBright": {
19                    "enable": true,
20                    "interval": 1000,
21                    "threshold": 0.5,
22                    "duration": 2000
23                },
24                "reddish": {
25                    "enable": true,
26                    "interval": 1000,
27                    "threshold": 0.6,
28                    "duration": 2000
29                },
30                "mosaic": {
31                    "enable": true,
32                    "interval": 1000,
33                    "duration": 2000
34                }
35            }
36        },
37        {
38            "state": "ACTIVE",
39            "presetType": "CUSTOM",
40            "createTime": "2021-05-20T20:14:00Z",
41            "presetName": "customlized_video_defect_detect_preset2",
42            "description": "An example video_defect_detect preset description 2",
43            "models": {
44                "tooBright": {
45                    "enable": true,
46                    "interval": 1000,
47                    "threshold": 0.5,
48                    "duration": 2000
49                }
50            }
51        }
52    ]
53}

更新视频质检模板

接口描述

通过presetName更新视频质检模板。

请求（Request）

请求语法：

Http

1PUT /v{version}/preset/video_defect_detect/{presetName} 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参数
请求参数：

字段名称	字段类型	必要性	字段描述	可选值	默认值
presetName	String	可选	任务的模板名称	-	-

请求体：同[创建视频质检模板/请求/请求体]

请求示例：

Http

1PUT /v3/preset/video_defect_detect/customlized_video_defect_detect_preset HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: 2021-05-21T21:31:21Z
4host: media.bj.baidubce.com
5accept: */*
6connection: keep-alive
7x-bce-request-id: 0969b91e-1890-470b-b93b-97939f672e54
8content-type: application/json
9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2020-02-14T15:12:37Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
10
11{
12    "presetName": "customlized_video_defect_detect_preset",
13    "description": "An example video_defect_detect preset description",
14    "models": {
15        "tooBright": {
16            "enable": true,
17            "interval": 1000,
18            "threshold": 0.5,
19            "duration": 2000
20        },
21        "reddish": {
22            "enable": true,
23            "interval": 1000,
24            "threshold": 0.5,
25            "duration": 2000
26        },
27        "mosaic": {
28            "enable": true,
29            "interval": 1000,
30            "duration": 2000
31        }
32    }
33}

响应（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, 21 May 2021 21:31:22 GMT
7Content-Type: application/json;charset=UTF-8

删除视频质检模板

接口描述

通过presetName删除视频质检模板。

请求（Request）

请求语法：

Http

1DELETE /v{version}/preset/video_defect_detect/{presetName} 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参数
请求参数：

字段名称	字段类型	必要性	字段描述	可选值	默认值
presetName	String	可选	任务的模板名称	-	-

请求体：无

请求示例：

Http

1DELETE /v{version}/preset/video_defect_detect/customlized_video_defect_detect_preset HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: 2021-05-21T21:41: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参数
响应参数：无
响应体：无

响应示例：

Http

1HTTP/1.1 200 OK
2x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
3Cache-Control: no-cache

抽帧任务接口

使用须知

音视频处理 MCT

音视频处理 MCT

视频质量检测模板接口

创建视频质检模板

ModelsParm

ModelParm

查询指定视频质检模板

查询当前用户及系统的所有模板

VddPreset

更新视频质检模板

删除视频质检模板