点播信息提交接口

接口地址

http://as.dun.163.com/v3/video/submit

接口描述

提交点播视频相关信息接口,信息提交后,易盾会根据客户自己设置的截图频率对点播视频进行截图检测,检测结果需产品自行定期调用视频结果获取接口获取。

支持格式

检测接口支持的视频封装格式:flv、mkv 、mp4 、rmvb 、avi 、wmv、3gp、ts、mov等。

大小限制

视频大小限制:<5G。

请求参数

公共参数已省略,详细见 请求公共参数

基本参数

参数名称类型是否必选最大长度描述
urlStringY512点播视频地址
dataIdStringY128点播视频唯一标识
versionStringY4接口版本号,可选值 v3.1
titleStringN512视频名称
callbackStringN512数据回调参数,产品根据业务情况自行设计,当获取离线检测结果时,易盾内容安全服务会返回该字段
callbackUrlStringN256离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。
uniqueKeyStringN64客户个性化视频唯一性标识,传入后,将以此值作为重复检测依据,若不传,默认以URL作为查重依据

业务扩展参数

业务扩展参数,有助于通过业务维度辅助反垃圾结果判定

参数名称类型是否必选最大长度描述
accountStringN128用户唯一标识
ipStringN128用户 IP 地址

截帧频率指定

参数名称类型是否必选最大长度描述
scFrequencyNumberN4默认截帧设置,默认5秒截图检测一次,可设置范围为0.5~600秒
advancedFrequencyjson字符串N128高级截帧设置,此项填写,默认截帧策略失效

advancedFrequency字符串数据结构

参数名称类型是否必选最大长度描述
durationPoints数组Y5视频时长区间分割,单位为秒
frequencies数组Y6视频时长区间对应的截帧频率,可设置范围为0.5~600秒

高级截帧配置说明

◆ 高级截帧配置适用于需要根据视频时长,设定不同截帧频率的场景,例如您需将5分钟以内的视频按照1s/帧截图,5分钟-10分钟的视频按照5s/帧截图,大于10分钟的视频按照10s/帧截图,advancedFrequency字符串应传入:

{

"durationPoints":[300,600],

"frequencies":[1,5,10]

}

◆ 高级截帧频率配置后,默认截帧频率即失效

响应结果

响应字段如下,响应通用字段已省略,详细见 响应通用字段

参数名称类型描述
taskIdString本次请求数据标识,可以根据该标识查询数据最新结果
statusNumber检测结果,0:成功,1:失败
dealingCountNumber缓冲池排队待处理数据量

缓冲池排队待处理量说明

为减少用户重试,优化用户体验,易盾为点播视频用户提供了缓冲池功能,点播视频正式的并发处理为30路,提交超并发后即自动进入缓冲池排队过检,您可以根据缓冲池排队积压量评估您目前的并发处理速度是否合适,如需调整处理并发请联系您的专属商务处理。

响应示例

输出结果:

{
    "code":200,
    "msg":"ok",
    "result":{
        "taskId":"f67fee0890de4c118d4f672b7c8ee304",
        "status":0,
        "dealingCount":1
    }
}