点播音视频解决方案提交接口

2021.10.18 17:48:19

    接口地址

    http://as.dun.163.com/v1/videosolution/submit

    接口描述

    提交音视频的URL进行检测,建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。

    查看v1.2提交接口文档

    支持格式

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

    大小限制

    视频大小限制:<5G。

    请求参数

    公共参数已省略,详细见 请求公共参数,businessId可不传,其他参数如下:

    参数名称 类型 是否必选 最大长度 描述
    dataId String N 128 数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
    version String Y 4 接口版本v1.3
    ip String N 128 用户IP地址
    account String N 128 用户唯一标识,如果无需登录则为空
    deviceId String N 128 用户设备 id,与易盾设备画像库匹配,明文请转大写传入;MD5加密请明文转大写后MD5计算,再转大写传入,建议抄送
    deviceType Number N 4 用户设备id的类型,0:其他,10:IMEI,11:AndroidID,12:IDFA,13:IDFV,14:MAC ,20:IMEI_MD5,21:AndroidID_MD5,22:IDFA_MD5,23:IDFV_MD5,24:MAC_MD5
    url String Y 512 音视频url
    title String N 512 音视频标题,传入后自动进行反垃圾检测
    images String(json数组) N 10张或5MB 音视频封面/简介图片,images为json数组,支持批量检测,传入后自动进行反垃圾检测
    content String N 1000 音视频简介,传入后自动进行反垃圾检测
    detectType Number N 1 机器过检类型,15:视频与音频同时过检,14:仅过检视频,13:仅过检音频,不填写默认为15,请注意
    scFrequency Number N 4 截图检测频率,默认5秒截图检测一次,可设置范围为0.5~60秒
    callback String N 512 数据回调参数,调用方根据业务情况自行设计,当调用音视频解决方案离线接口获取结果时,该接口会原样返回该字段。作为数据处理标识,因此该字段应该设计为能唯一定位到该次请求的数据结构,如对用户的昵称进行检测,dataId可设为用户标识(用户ID),用户修改多次,每次请求数据的dataId可能一致,但是callback参数可以设计成定位该次请求的数据结构,比如callback字段设计成json,包含dataId和请求的时间戳等信息,当然如果不想做区分,也可以直接把callback设置成dataId的值。
    callbackUrl String N 1024 离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。
    uniqueKey String N 64 客户个性化唯一性标识,传入后,将以此值作为重复检测依据,若不传,默认以URL作为查重依据,此参数在v1.2以上版本支持请注意version传入,如果重复提交会被拒绝,返回报错信息请求重复,以及原提交taskID值,具体返回请查看响应示例
    relationId String N 128 聚合音视频id,自定义内容传参
    relationSearchId String N 128 聚合审核关联查询参数,需传入需关联视频对应的relationId
    priorityId String N 4 用于在聚合审核场景,左侧审核列表在同嫌疑程度下按传入优先级排序展示
    tags String(json数组) N 131 业务标签,用于特殊标识某类音视频,支持最多传入5个标签,每个标签最大长度10,建议传1个

    images 数据结构

    参数名称 类型 是否必选 最大长度 描述
    name String Y 1024 图片名称(或图片标识), 该字段为回调信号字段,产品可以根据业务情况自行设计,如json结构、或者为图片url均可
    type Number Y 4 类型,分别为1:图片URL,2:图片BASE64值
    data String Y 10张或5MB 图片内容,如type=1,则该值为图片URL,如type=2,则该值为图片BASE64值。图片URL检测单次请求最多支持10张,图片BASE64值检测单次请求大小限制为最多5MB

    响应结果

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

    result 数据结构

    参数名称 类型 描述
    taskId String 本次请求数据标识,可以根据该标识查询数据最新结果
    dataId String 数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
    dealingCount Number 缓冲池排队待处理数据量

    响应示例

    {
        "code": 200,
        "msg": "ok",
        "result": {
                "taskId": "******",
                "dataId": "******",
    	    "dealingCount":123
            }
    }
    

    重复检测返回结构

    1.uniqueKey提交重复

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

    {
        "code":417,
        "msg":"返回原提交taskID值"
     }
    
    
    Online Chat Tel:95163223