Help Center

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

2023.09.22 17:31:52

接口地址

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秒
advancedFrequency	String	否	128	高级截帧设置，此项填写，默认截帧策略失效，如{"durationPoints":[300,600],"frequencies":[1,5,10]}
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个

advancedFrequency数据结构

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

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值"
 }

Comment On The Document:

If you encounter product-related problems, you can Submit a ticket 或Online ChatSeek help.

Online Chat Tel：95163223 Free trial