本文提供了调用视频指纹检索任务的具体内容,帮助您编写程序构建HTTP调用请求。

  • 关于如何构造HTTP请求,请参见请求结构
  • 您也可以直接选用已构造好的HTTP请求,具体请参见SDK 概览

描述

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

调用本接口在指定视频分组中检索与待检测视频相似的视频。

该接口为异步接口,提交检索任务后,您可以通过返回的taskId调用查询接口获取检索结果。更多信息,请参见查询视频指纹检索结果

待检测视频需要满足以下要求:
  • 视频文件链接支持以下协议:HTTP和HTTPS。
  • 视频文件支持以下格式:AVI、FLV、MP4、MPG、ASF、WMV、MOV、WMA、RMVB、RM、FLASH、TS。
  • 视频大小限制:单个视频大小不超过200MB。如果您有特殊需求(大视频),可以提工单进行调整。
  • 视频流支持以下协议:RTMP、HLS、HTTP-FLV、RTSP。
  • 视频流时长限制:单个视频流检测任务最长支持24小时,超过24小时任务自动结束。
  • 视频检测的时间依赖于视频的下载时间。请保证被检测的视频文件所在的存储服务稳定可靠,建议您使用阿里云OSS存储服务存储视频文件。

请求参数

名称 类型 是否必须 描述
bizType 字符串 该字段用于标识业务场景。针对不同的业务场景,您可以配置不同的内容审核策略,以满足不同场景下不同的审核标准或算法策略的需求。您可以通过云盾内容安全控制台创建业务场景(bizType),或者通过工单联系我们帮助您创建业务场景。
scenes 字符串数组 指定检测场景,视频指纹检索场景的取值:video-dna
callback 字符串 异步检测结果回调通知您的URL,支持HTTP/HTTPS。
说明 如果该字段为空,则您必须定时检索检测结果。
seed 字符串 回调通知请求中的签名。
说明 传入callback时,也必须传入该字段。
tasks JSON数组 指定检测任务列表。JSON数组中的每个元素是一个结构体,具体结构描述请参见video
表 1. video
名称 类型 是否必须 描述
clientInfo JSON结构体 客户端信息,请参见公共参数中的公共查询参数。
服务器会把全局的clientInfo和此处独立的clientInfo合并。
说明 独立的clientInfo优先级更高。
dataId 字符串 待检测数据的ID。您需要保证在一次请求中,所有的dataId不重复。
url 字符串 待检测视频的地址。
extras map 待检测的视频分组的groupId,指定从该视频分组中检测相似视频。

返回参数

名称 类型 是否必须 描述
taskId 字符串 检测任务的ID。
dataId 字符串 对应请求中的dataId
url 字符串 对应请求中的url

示例

请求示例
{
    "scenes": [
        "video-dna"
    ],
    "tasks": [
        {
            "dataId": "videoId xxx",
            "url": "http://xxx.xxxx.mp4",
            "extras": [
                {
                    "groupId": "group1"
                }
            ]
        }
    ]
}
返回示例
{
    "code": 200,
    "msg": "OK",
    "requestId": "requestID xxx",
    "data": [
        {
            "dataId": "videoId xxx",
            "taskId": "taskId xxx"
        }
    ]
}