提交视频指纹检索任务后,您可以调用本接口查询检测结果。

描述

业务接口/green/video/results
说明 目前视频指纹检索功能的 endpoint仅支持 cn-shanghai

根据检索任务的taskId查询异步检索结果。

请求参数

关于在请求中必须包含的公共请求参数,请参考公共参数

请求body是一个JSON对象,字段说明如下:
名称 类型 是否必需 描述
body JSON数组 要查询的taskId列表。最多支持查询100个任务。

返回参数

返回结果说明,参见返回结果

返回body中的data字段是JSON数组,每一个元素包含如下字段:
名称 类型 是否必需 描述
code 整形 错误码,和HTTP的status code一致。
msg 字符串 错误描述信息。
dataId 字符串 对应的请求中的dataId
taskId 字符串 该检测任务的ID。
url 字符串 对应的请求中的url。当请求中没有url时,该字段为空。
results 数组 检测成功时(code = 200)返回的检测结果。该结果包含一个或多个元素,每个元素是个结构体,具体结构见result
表 1. result
名称 类型 是否必需 描述
scene 字符串 检测场景,取值为:video-dna
suggestion 字符串 检测结果处理建议,取值:
  • pass:未在指定视频库中检测到相似视频,建议您不做任何操作
  • block:在指定视频库中检测到相似视频,建议您执行下一步操作
label 字符串 检测结果的分类标签,取值:
  • normal:未检索到相似视频
  • video-dna:检索到相似视频
rate 浮点数 结果为该分类的概率,取值范围[0.00-100.00]。值越高表示越有可能属于该分类。
videoDnaData JSON数组 当检测到相似视频时,返回相似视频的信息。具体结构见videoDnaData
表 2. videoDnaData
名称 类型 是否必需 描述
rate 字符串 与被检测视频相似的概率。
videoId 字符串 与被检测视频相似的视频ID。
segments JSON数组 匹配到的相似视频片段信息。具体结构见segment
表 3. segment
名称 类型 是否必需 描述
duration Intger 视频片段的长度,单位为秒。
offset Intger 视频片段的开始时间,单位为秒。
subVideoId Integer 视频片段的ID。

示例

请求示例
[
  "taskId xxx",
  "taskId bbb"
]
返回示例
{
	"msg":"OK",
	"code":200,
	"data":[
		{
			"msg":"OK",
			"code":200,
			"dataId":"1908341538487173_test46Rf$aRurHh66UWeTd8EpIB-1pqUUv",
			"results":[
				{
					"videoDnaData":[
						{
							"rate":1.0,
							"videoId":45062793854215176,
							"segments":[
								{
									"duration":60,
									"offset":0,
									"subVideoId":11
								},
								{
									"duration":60,
									"offset":60,
									"subVideoId":12
								},
								{
									"duration":60,
									"offset":120,
									"subVideoId":13
								},
								{
									"duration":60,
									"offset":180,
									"subVideoId":14
								},
								{
									"duration":27,
									"offset":240,
									"subVideoId":15
								}
							]
						}
					],
					"rate":100.0,
					"suggestion":"block",
					"label":"video-dna",
					"scene":"video-dna"
				}
			],
			"taskId":"vi5UQ2FeRqQtX6AIhcSoVpT2-1pqUUw",
			"url":"aligreen-shanghai/pre/hammal/061454f5c/254_45062793854215176"
		}
	],
	"requestId":"A5003ED4-B1A9-48D3-9DD7-C6E887977087"
}