提交视频指纹检索任务后,您可以调用本接口查询检测结果。
描述
业务接口:
/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。 |
名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
scene | 字符串 | 是 | 检测场景,取值为:video-dna |
suggestion | 字符串 | 是 | 检测结果处理建议,取值:
|
label | 字符串 | 是 | 检测结果的分类标签,取值:
|
rate | 浮点数 | 是 | 结果为该分类的概率,取值范围[0.00-100.00]。值越高表示越有可能属于该分类。 |
videoDnaData | JSON数组 | 否 | 当检测到相似视频时,返回相似视频的信息。具体结构见videoDnaData。 |
名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
rate | 浮点型 | 是 | 视频相似分。 |
videoId | 长整型(Long) | 是 | 相似视频ID。 |
segments | JSON数组 | 是 | 匹配到的相似视频片段信息。具体结构见segment。 |
videoPercent | 浮点型 | 否 | 检索视频时长占比。 |
samplePercent | 浮点型 | 否 | 样本视频时长占比。 |
名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
duration | 整型 | 是 | 检索视频片段的长度,单位为秒。 |
offset | 整型 | 是 | 检索视频片段的开始时间,单位为秒。 |
sampleDuration | 整型 | 是 | 样本视频片段的长度,单位为秒 |
sampleOffset | 整型 | 是 | 样本视频片段的开始时间,单位为秒 |
rate | 浮点型 | 否 | 视频段相似分。 |
示例
请求示例
[
"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"
}
在文档使用中是否遇到以下问题
更多建议
匿名提交