接口地址

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

接口描述

提交点播视频相关信息接口，信息提交后，易盾会根据客户自己设置的截图频率对点播视频进行截图检测，检测结果需产品自行定期调用视频结果获取接口获取。建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。

查看v3.1提交接口文档

支持格式

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

大小限制

视频大小限制：<5G。

请求参数

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

基本参数

参数名称	类型	是否必选	最大长度	描述
url	String	Y	512	点播视频地址
dataId	String	Y	128	点播视频唯一标识
version	String	Y	4	接口版本号，可选值 v3.2
title	String	N	512	视频名称
callback	String	N	512	数据回调参数，产品根据业务情况自行设计，当获取离线检测结果时，易盾内容安全服务会返回该字段
callbackUrl	String	N	256	离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s，为了保证顺利接收数据，需保证接收接口性能稳定并且保证幂等性。
uniqueKey	String	N	64	客户个性化视频唯一性标识，传入后，将以此值作为重复检测依据，若不传，默认以URL作为查重依据,如果重复提交会被拒绝，返回报错信息请求重复，以及原提交taskID值，具体返回请查看响应示例
subProduct	String	N	32	业务结算id(自定义),业务方传入参数，用于资源账单统计,如需开启请联系易盾客户经理。开启之后资源账单按套餐结算sheet增加subProduct维度的数据请求量、检测量、消耗金额的统计

业务扩展参数

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

参数名称	类型	是否必选	最大长度	描述
用户信息	-	N	-	用户信息包含账号、昵称、等级、角色等，请查看 业务扩展参数—用户信息
设备信息	-	N	-	设备信息包含设备ID、设备ID类型等，请查看 业务扩展参数—设备信息
场景信息	-	N	-	场景信息包含私聊、群聊、直播、帖子等场景字段，请查看 业务扩展参数—场景信息
ip	String	N	128	用户 IP 地址
extension	String	N	30000	自定义扩展参数

截帧频率指定

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

advancedFrequency字符串数据结构

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

高级截帧配置说明

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

{

"durationPoints":[300,600],

"frequencies":[1,5,10]

}

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

响应结果

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

参数名称	类型	描述
taskId	String	本次请求数据标识，可以根据该标识查询数据最新结果
status	Number	检测结果，0：成功，1：失败
dealingCount	Number	缓冲池排队待处理数据量

缓冲池排队待处理量说明

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

响应示例

输出结果：

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

重复检测返回结构

1.uniqueKey提交重复

2.如果不传uniqueKey默认以url做判断，如若当前有正在检测的url,重复检测按照失败返回

{
    "code":417,
    "msg":"返回原提交taskID值"
 }