QueryVideoQualityJob - 查询视频质量审核作业

查询视频质量审核作业的状态与结果。

接口说明

本接口目前支持的地域为华东2（上海）。
本接口通过视频质量审核作业的ID对作业结果进行查询。

QPS限制

本接口的单用户QPS限制为50次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
UserId	long	是	用户ID。可以通过MPS控制台顶部导航栏左侧单击头像查看。	125340688170****
JobId	string	是	需要查询的视频质量审核作业ID。可以从提交视频质量审核作业的返回参数中获取。	7c2abbb270474c98823dac56cc06****

返回参数

名称	类型	描述	示例值
	object	返回参数。
Message	string	作业信息。	The job is completed successfully
RequestId	string	请求ID。	5210DBB0-E327-4D45-ADBC-0B83C8796E26
Job	object	作业详情。
Status	string	作业状态。可取值： Success：处理成功。 Fail：处理失败。 Processing：处理中。 Submitted：已提交等待处理。	Success
JobId	string	作业ID。	0c8f04aa60bd4377a906bd6c91ec****
UserId	long	用户ID。	125340688170****
VideoQualityResults	string	审核结果摘要，有质量问题的图片信息列表，不含坐标信息。	{"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	string	作业信息。	The job is completed successfully
Output	string	审核结果汇总，存放于用户提供的输出文件OSS地址。例如：`oss://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example1.txt`，用户根据需要解析。格式示例： `{"审核标签一":[ {问题帧一}, {问题帧二}, ... , {问题帧N}]} {"审核标签二":[ {问题帧一}, {问题帧二}, ... , {问题帧N}]} ... {"审核标签N":[ {问题帧一}, {问题帧二}, ... , {问题帧N}]}`	oss://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example1.txt
Code	string	错误码。请求成功时返回Success。	Success

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"
}

错误码

访问错误中心查看更多错误码。