查询视频质量审核作业的状态与结果。
接口说明
- 本接口目前支持的地域为华东2(上海)。
- 本接口通过视频质量审核作业的ID对作业结果进行查询。
QPS限制
本接口的单用户QPS限制为50次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
UserId | long | 是 | 用户ID。可以通过MPS控制台顶部导航栏左侧单击头像查看。 | 125340688170**** |
JobId | string | 是 | 需要查询的视频质量审核作业ID。可以从提交视频质量审核作业的返回参数中获取。 | 7c2abbb270474c98823dac56cc06**** |
返回参数
VideoQualityResults示例
"VideoQualityResults":{
"Blockness":[
{
"TimeStamp":"hh:mm:ss[.SSS]",
"Score":"0.33"
},
{
"TimeStamp":"hh:mm:ss[.SSS]",
"Score":"0.66"
}
],
"Brightness":[
{
"TimeStamp":"hh:mm:ss[.SSS]",
"Result":"white",
"Score":"0.33"
},
{
"TimeStamp":"hh:mm:ss[.SSS]",
"Result":"white",
"Score":"0.66"
}
],
"Freeze":[
{
"TimeStamp":"hh:mm:ss[.SSS]",
"Score":"0.33"
},
{
"TimeStamp":"hh:mm:ss[.SSS]",
"Score":"0.66"
}
],
"ImageDefinition":[
{
"TimeStamp":"hh:mm:ss[.SSS]"
},
{
"TimeStamp":"hh:mm:ss[.SSS]",
}
],
"LessExpose":[
{
"TimeStamp":"hh:mm:ss[.SSS]",
"Ratio":"0.33"
},
{
"TimeStamp":"hh:mm:ss[.SSS]",
"Ratio":"0.66"
}
],
"OverExpose":[
{
"TimeStamp":"hh:mm:ss[.SSS]",
"Ratio":"0.33"
},
{
"TimeStamp":"hh:mm:ss[.SSS]",
"Ratio":"0.66"
}
],
"Border":[
{
"TimeStamp":"hh:mm:ss[.SSS]"
},
{
"TimeStamp":"hh:mm:ss[.SSS]"
}
],
"Noise":[
{
"TimeStamp":"hh:mm:ss[.SSS]",
"Ratio":"0.33"
},
{
"TimeStamp":"hh:mm:ss[.SSS]",
"Ratio":"0.66"
}
],
"Mosaic":[
{
"TimeStamp":"hh:mm:ss[.SSS]"
},
{
"TimeStamp":"hh:mm:ss[.SSS]"
}
]
}
Output示例
{
"brightness": [{
"result": "dark",
"score": -2.5150070190429688,
"timestamp": "5520",
"type": "brightness"
}, {
"result": "dark",
"score": -2.1238651275634766,
"timestamp": "344000",
"type": "brightness"
}]
} {
"blockness": [{
"result": "blocking",
"score": 4.1806020736694336,
"timestamp": "160",
"type": "blockness"
}, {
"result": "blocking",
"score": 4.515049934387207,
"timestamp": "240",
"type": "blockness"
}]
} {
"freeze": [{
"result": "freeze",
"score": 4.1445174217224121,
"timestamp": "202240",
"type": "freeze"
}]
} {
"border": [{
"border": [0, 0, 1280, 720],
"id": 25,
"timestamp": 1000.0
}, {
"border": [1, 0, 1279, 720],
"id": 50,
"timestamp": 2000.0
}]
} {
"mosaic": [{
"box": [
[294, 59, 328, 93],
[124, 98, 168, 142],
[268, 109, 300, 141],
[162, 109, 194, 141],
[268, 76, 300, 108],
[162, 59, 194, 91],
[94, 73, 130, 109],
[94, 28, 130, 64],
[294, 94, 328, 128],
[222, 21, 266, 65],
[203, 21, 247, 65],
[241, 33, 273, 65],
[190, 59, 220, 89],
[333, 59, 367, 93],
[314, 59, 358, 103],
[124, 53, 168, 97],
[361, 59, 391, 89],
[1029, 77, 1057, 105],
[349, 59, 379, 89]
],
"id": 25,
"timestamp": 1000.0
}, {
"box": [
[241, 33, 273, 65],
[228, 33, 260, 65],
[189, 81, 221, 113],
[336, 75, 366, 105],
[254, 21, 298, 65],
[163, 60, 205, 102],
[320, 59, 354, 93],
[125, 97, 169, 141],
[221, 39, 247, 65]
],
"id": 50,
"timestamp": 2000.0
}]
} {
"over_expose": [{
"ratio": "0.97276288701703",
"id": 25,
"timestamp": 1000.0
}, {
"ratio": "0.8629491725526869",
"id": 50,
"timestamp": 2000.0
}]
}
视频质量审核结果算法各字段含义
花屏识别(blockness)
字段 | 含义 |
---|---|
result | 检测结果:blocking和normal |
score | 结果置信度 |
timestamp | 问题帧发生时间,单位:ms。 |
黑屏、白屏(brightness)
字段 | 含义 |
---|---|
result | 检测结果:dark,bright,black,white,normal |
score | 结果置信度 |
timestamp | 问题帧发生时间,单位:ms。 |
静帧(freeze)
字段 | 含义 |
---|---|
result | 检测结果:freeze,normal |
score | 结果置信度 |
timestamp | 问题帧发生时间,单位:ms。 |
模糊识别(image_definition)
字段 | 含义 |
---|---|
id | 问题帧 |
timestamp | 问题帧发生时间,单位:ms。 |
低光照识别(less_expose)
字段 | 含义 |
---|---|
ratio | 欠曝比例 |
id | 问题帧 |
timestamp | 问题帧发生时间,单位:ms。 |
过曝光识别(over_expose)
字段 | 含义 |
---|---|
ratio | 过曝比例 |
id | 问题帧 |
timestamp | 问题帧发生时间,单位:ms。 |
黑边、白边(border)
字段 | 含义 |
---|---|
border | 图片的位置 [x1,y1,x2,y2] |
id | 问题帧 |
timestamp | 问题帧发生时间,单位:ms。 |
马赛克识别(mosaic)
字段 | 含义 |
---|---|
box | 马赛克位置[x1,y1,x2,y2] |
id | 问题帧 |
timestamp | 问题帧发生时间,单位:ms。 |
雪花/噪点识别(noise)
字段 | 含义 |
---|---|
noise_rate | 噪声比例 |
id | 问题帧 |
timestamp | 问题帧发生时间,单位:ms。 |
示例
正常返回示例
JSON
格式
{
"Message": "The job is completed successfully",
"RequestId": "5210DBB0-E327-4D45-ADBC-0B83C8796E26",
"Job": {
"Status": "Success",
"JobId": "0c8f04aa60bd4377a906bd6c91ec****",
"UserId": 0,
"VideoQualityResults": "{\"LessExpose\":[{\"Ratio\":\"0.917673658134****\",\"TimeStamp\":\"00:00:10.0\"}],\"Noise\":[{\"Ratio\":\"0.0419343847352\",\"TimeStamp\":\"00:00:05.0\"}],\"ImageDefinition\":[{\"TimeStamp\":\"00:00:05.0\"},{\"TimeStamp\":\"00:00:10.0\"}],\"Border\":[{\"TimeStamp\":\"00:00:05.0\"},{\"TimeStamp\":\"00:00:10.0\"}],\"Freeze\":[{\"Score\":\"1\",\"TimeStamp\":\"00:00:00.233\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:02.600\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:02.900\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:02.933\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:03.400\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:05.166\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:05.800\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:07.700\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:07.800\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:08.633\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:08.833\"},{\"Score\":\"1\",\"TimeStamp\":\"00:00:09.0\"}]}",
"Message": "The job is completed successfully",
"Output": "oss://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example1.txt"
},
"Code": "Success"
}
错误码
访问错误中心查看更多错误码。