帮助中心

直播语音信息提交接口

2023.09.22 17:31:02

接口地址

https://as.dun.163.com/v3/liveaudio/check

接口描述

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

请求参数

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

参数名称	类型	是否必选	最大长度	描述
version	String	Y	4	接口版本 v3.1
url	String	Y	1024	直播语音url
dataId	String	Y	128	直播流唯一标识，直播ID
title	String	N	512	直播语音标题
ip	String	N	128	用户IP地址
account	String	N	128	用户唯一标识，如果无需登录则为空
roomNo	String	N	128	主播房间号
accountLevel	String	N	10	账号级别/主播级别(大写A-Z)
accountName	String	N	30	账号名称/主播名称
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	1024	数据回调参数，调用方根据业务情况自行设计，当调用callback接口获取直播音频结果时，该接口会原样返回该字段，详细见直播音频离线检测结果获取。作为数据处理标识，因此该字段应该设计为能唯一定位到该次请求的数据结构，如对用户的昵称进行检测，dataId可设为用户标识（用户ID），用户修改多次，每次请求数据的dataId可能一致，但是callback参数可以设计成定位该次请求的数据结构，比如callback字段设计成json，包含dataId和请求的时间戳等信息，当然如果不想做区分，也可以直接把callback设置成dataId的值。
callbackUrl	String	N	512	离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s，为了保证顺利接收数据，需保证接收接口性能稳定并且保证幂等性。
uniqueKey	String	N	256	客户个性化直播流唯一性标识，传入后，将以此值作为重复检测依据，若不传，默认以URL作为查重依据

响应结果

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

result 数据结构

参数名称	类型	描述
taskId	String	本次请求数据标识，可以根据该标识查询数据最新结果
status	Number	请求结果，0为成功，1为失败

响应示例

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

上一篇：点播语音在线检测接口v1 下一篇：结果获取接口

对文档做个评价吧：

如果遇到产品相关问题，您可提交工单或在线咨询寻求帮助。

在线咨询电话咨询：95163223 免费试用