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

描述

业务接口/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
videoPercent 字符串 检索视频时长占比。
samplePercent 字符串 样本视频时长占比。
表 3. segment
名称 类型 是否必需 描述
duration Intger 检索视频片段的长度,单位为秒。
offset Intger 检索视频片段的开始时间,单位为秒。
sampleDuration Integer 样本视频片段的长度,单位为秒
sampleOffset Integer 样本视频片段的开始时间,单位为秒
rate Float 视频段相似分。

示例

请求示例
[
  "taskId xxx",
  "taskId bbb"
]
返回示例
{
    "msg": "OK",
    "code": 200,
    "data": [
        {
            "msg": "OK",
            "code": 200,
            "dataId": "sh15OxBc6xYXgo45k6iR@h8VD-1pMMPE",
            "results": [
                {
                    "videoDnaData": [
                        {
                            "rate": 92.0,
                            "samplePercent": 100.0,
                            "videoPercent": 98.78,
                            "videoId": 56430133766466561,
                            "segments": [
                                {
                                    "duration": 60,
                                    "offset": 20,
                                    "rate": 81.0,
                                    "sampleOffset": 0,
                                    "sampleDuration": 60
                                },
                                {
                                    "duration": 60,
                                    "offset": 80,
                                    "rate": 88.0,
                                    "sampleOffset": 60,
                                    "sampleDuration": 60
                                },
                                {
                                    "duration": 22,
                                    "offset": 140,
                                    "rate": 92.0,
                                    "sampleOffset": 120,
                                    "sampleDuration": 42
                                }
                            ]
                        }
                    ],
                    "rate": 92.0,
                    "suggestion": "block",
                    "label": "video-dna",
                    "scene": "video-dna"
                }
            ],
            "taskId": "vi6p6xrPmkXaM5zS5qbbxgK@-1pMMPF",
            "url": "http://xxx/xxx.mp4"
        }
    ],
    "requestId": "6C83CF18-4537-48C1-A4AE-0119F53305B0"
}