视频质量检测模板接口

更新时间：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

缩略图任务接口

视频质量检测任务接口

百度智能云

音视频处理 MCP

音视频处理 MCP

视频质量检测模板接口

创建视频质检模板

ModelsParm

ModelParm

查询指定视频质检模板

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

VddPreset

更新视频质检模板

删除视频质检模板