视频质量检测模板接口

更新时间：2022-12-21

创建视频质检模板

接口描述

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

请求（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	可选	模板描述	-	-
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]，设定阈值越大，表示检测门槛越高。

请求示例

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",
    "models": {
        "tooBright": {
            "enable": true,
            "interval": 1000,
            "threshold": 0.5,
            "duration": 2000
        },
        "reddish": {
            "enable": true,
            "interval": 1000,
            "threshold": 0.6,
            "duration": 2000
        },
        "mosaic": {
            "enable": true,
            "interval": 1000,
            "duration": 2000
        }
    }
}

响应（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，分别表示系统内置模板/用户自定义模板
createTime	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",
    "createTime": "2021-05-20T21:13:00Z",
    "presetName": "customlized_video_defect_detect_preset",
    "description": "An example video_defect_detect preset description",
    "models": {
        "tooBright": {
            "enable": true,
            "interval": 1000,
            "threshold": 0.5,
            "duration": 2000
        },
        "reddish": {
            "enable": true,
            "interval": 1000,
            "threshold": 0.6,
            "duration": 2000
        },
        "mosaic": {
            "enable": true,
            "interval": 1000,
            "duration": 2000
        }
    }
}

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

接口描述

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

请求（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",
            "createTime": "2021-05-20T21:13:00Z",
            "presetName": "customlized_video_defect_detect_preset",
            "description": "An example video_defect_detect preset description",
            "models": {
                "tooBright": {
                    "enable": true,
                    "interval": 1000,
                    "threshold": 0.5,
                    "duration": 2000
                },
                "reddish": {
                    "enable": true,
                    "interval": 1000,
                    "threshold": 0.6,
                    "duration": 2000
                },
                "mosaic": {
                    "enable": true,
                    "interval": 1000,
                    "duration": 2000
                }
            }
        },
        {
            "state": "ACTIVE",
            "presetType": "CUSTOM",
            "createTime": "2021-05-20T20:14:00Z",
            "presetName": "customlized_video_defect_detect_preset2",
            "description": "An example video_defect_detect preset description 2",
            "models": {
                "tooBright": {
                    "enable": true,
                    "interval": 1000,
                    "threshold": 0.5,
                    "duration": 2000
                }
            }
        }
    ]
}

更新视频质检模板

接口描述

通过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",
    "models": {
        "tooBright": {
            "enable": true,
            "interval": 1000,
            "threshold": 0.5,
            "duration": 2000
        },
        "reddish": {
            "enable": true,
            "interval": 1000,
            "threshold": 0.5,
            "duration": 2000
        },
        "mosaic": {
            "enable": true,
            "interval": 1000,
            "duration": 2000
        }
    }
}

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

抽帧任务接口

视频质量检测任务接口

百度智能云

音视频处理 MCP

音视频处理 MCP

视频质量检测模板接口

创建视频质检模板

ModelsParm

ModelParm

查询指定视频质检模板

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

VddPreset

更新视频质检模板

删除视频质检模板