点播视频提交接口

2022.05.18 09:55:55

    接口地址

    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值"
     }
    
    
    Online Chat Tel:95163223