点播语音信息提交接口

2024.08.16 12:40:55

    接口地址

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

    接口描述

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

    查看v1.0提交接口文档

    查看v3.3提交接口文档

    音频文件限制

    1、音频文件大小不超过550M ,时长小于5小时

    2、音频文件格式支持:wav、mp3、aac、amr、3gp、m4a、wma、ogg、ape、flac、alac、wavpack、silk_v3等市场主流格式。

    请求参数

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

    参数名称 类型 是否必选 最大长度 描述
    url String Y 512 语音文件url
    version String Y 4 接口版本号,可选值 v3.5
    title String N 512 文件标题
    ip String N 32 用户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
    callback String N 2^16-1 数据回调参数,调用方根据业务情况自行设计,当调用离线结果获取接口时,该接口会原样返回该字段,详细见音频离线检测结果获取。作为数据处理标识,因此该字段应该设计为能唯一定位到该次请求的数据结构,如对用户的昵称进行检测,dataId可设为用户标识(用户ID),用户修改多次,每次请求数据的dataId可能一致,但是callback参数可以设计成定位该次请求的数据结构,比如callback字段设计成json,包含dataId和请求的时间戳等信息,当然如果不想做区分,也可以直接把callback设置成dataId的值。
    callbackUrl String N 256 离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。
    uniqueKey String 256 检测去重字段,填入后使用此字段去重,如果没填入则默认使用url进行去重
    subProduct String N 32 业务结算id(自定义),业务方传入参数,用于资源账单统计,如需开启请联系易盾客户经理。开启之后资源账单按套餐结算sheet增加subProduct维度的数据请求量、检测量、消耗金额的统计

    业务扩展参数

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

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

    响应结果

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

    result 数据结构

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

    缓冲池排队待处理量说明

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

    响应示例

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

    重复检测返回结构

    以url做判断,如若当前有正在检测的url,重复检测按照失败返回

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