接口地址

https://as.dun.163yun.com/v1/audio/check

接口描述

建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。

根据发布的内容、发布者、ip、设备等信息来检测是否为需拦截内容。接口同步返回易盾内容安全服务实时反垃圾引擎检测结果，产品可以根据该结果对数据进行初步过滤。

请求参数

该接口参数与请求公共参数一致，详细见 请求公共参数

语音文件URL提交

参数名称	类型	是否必选	最大长度	描述
dataCheckType	Number	N	1	检测类型，默认0-url，1-语音内容base64
url	String	N	1024	语音文件url，时长不超过60s
version	String	Y	4	接口版本号，可选值 v1
title	String	N	512	文件标题
ip	String	N	32	用户IP地址
account	String	N	128	用户唯一标识，如果无需登录则为空
deviceId	String	N	128	用户设备 id
deviceType	Number	N	4	用户设备类型，1：web， 2：wap， 3：android， 4：iphone， 5：ipad， 6：pc， 7：wp
callback	String	N	2^16-1	数据回调参数，调用方根据业务情况自行设计，当调用离线结果获取接口或查询接口时，该接口会原样返回该字段，详细见音频离线检测结果获取。作为数据处理标识，因此该字段应该设计为能唯一定位到该次请求的数据结构，如对用户的昵称进行检测，dataId可设为用户标识（用户ID），用户修改多次，每次请求数据的dataId可能一致，但是callback参数可以设计成定位该次请求的数据结构，比如callback字段设计成json，包含dataId和请求的时间戳等信息，当然如果不想做区分，也可以直接把callback设置成dataId的值。
callbackUrl	String	N	256	审核后离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s，为了保证顺利接收数据，需保证接收接口性能稳定并且保证幂等性。
format	String	N	1	语音内容格式，不区分大小写，可选值pcm
rate	Number	N	5	语音内容采样率，可选值16000
channel	Number	N	1	语音内容声道数，仅支持单声道，可选值1
extension	String	N	30000	自定义扩展参数

语音内容base64提交

参数名称	类型	是否必选	最大长度	描述
dataCheckType	Number	N	1	检测类型，默认0-url，1-语音内容base64
data	String	N	2560000	语音内容base64
format	String	N	3	语音内容格式，不区分大小写，可选值pcm，不填默认为pcm
rate	Number	N	5	语音内容采样率，可选值16000，不填默认为16000
channel	Number	N	1	语音内容声道数，仅支持单声道，可选值1，不填默认为1
version	String	Y	4	接口版本号，可选值 v1
title	String	N	512	文件标题
ip	String	N	32	用户IP地址
account	String	N	128	用户唯一标识，如果无需登录则为空
deviceId	String	N	128	用户设备 id
deviceType	Number	N	4	用户设备类型，1：web， 2：wap， 3：android， 4：iphone， 5：ipad， 6：pc， 7：wp
callback	String	N	2^16-1	数据回调参数，调用方根据业务情况自行设计，当调用离线结果获取接口或查询接口时，该接口会原样返回该字段，详细见音频离线检测结果获取。作为数据处理标识，因此该字段应该设计为能唯一定位到该次请求的数据结构，如对用户的昵称进行检测，dataId可设为用户标识（用户ID），用户修改多次，每次请求数据的dataId可能一致，但是callback参数可以设计成定位该次请求的数据结构，比如callback字段设计成json，包含dataId和请求的时间戳等信息，当然如果不想做区分，也可以直接把callback设置成dataId的值。
callbackUrl	String	N	256	审核后离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s，为了保证顺利接收数据，需保证接收接口性能稳定并且保证幂等性。

响应结果

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

反垃圾结果

result 数据结构

参数名称	类型	描述
taskId	String	点播视频提交生成的唯一数据标识，可以根据该标识查询视频数据最新结果
status	Number	0-检测成功 1-检测超时(后期可能新增，请保持扩展性)
antispam	json数组	反垃圾检测结果
language	json数组	语种检测结果
asr	json数组	语音识别检测结果
voice	json数组	人声识别检测结果

antispam 数组数据结构

参数名称	类型	描述
asrStatus	Number	音频翻译结果，2：检测中，3：检测完成，4：检测失败
asrResult	Number	音频翻译检测失败原因，1：文件格式错误，2：文件下载失败，3：解析失败，4：音频流不存在，5：同步检测音频时长超长(>60s)
action	Number	检测结果，0：通过，1：嫌疑，2：不通过
taskId	String	唯一标识
segments	json数组	断句信息
labels	json数组	分类信息
censorSource	Number	审核来源，0：易盾人审，1：客户人审，2：易盾机审
censorTime	Number	人工审核完成时间，毫秒单位时间戳(13位)
censorLabels	json数组	审核标签

segments 数据结构

参数名称	类型	描述
startTime	Number	开始时间，单位秒
endTime	Number	结束时间，单位秒
content	String	断句内容
label	Number	分类信息，100：色情，200：广告，260：广告法，300：暴恐，400：违禁，500：涉政，600：谩骂，900：其他，1100：涉价值观
level	Number	分类级别，0：通过，1：不确定，2：确定
leaderName	String	领导人名，若命中领导人声纹，返回对应的领导人名
hintList	json数组	其他信息

labels 数据结构

参数名称	类型	描述
label	Number	分类信息，100：色情，200：广告，260：广告法，300：暴恐，400：违禁，500：涉政，600：谩骂，900：其他，1100：涉价值观
level	String	分类级别，1：不确定，2：确定
subLabels	json数组	细分类信息，可能包含多个，可能为空

subLabels 数据结构

参数名称	类型	描述
details	json对象	其他信息
subLabel	json数组	细分类，详细编码请参考下方对应细分类编码对应表

自定义细分类

易盾支持sublabel自定义细分类过检并返回，如有需求，可联系您的专属安全策略经理添加。

details 数据结构

参数名称	类型	描述
hitType	Number	命中检测器类型：10：用户名单 11:IP名单 12:设备名单 30:敏感词 110:IP地区限制 130:声纹检测
hint	json数组	线索信息，用于定位文本中有问题的部分，辅助人工审核

hint 数据结构

参数名称	类型	描述
value	String	命中的敏感词或者声纹检测的分值
segments	json数组	命中敏感词或者声纹检测的音频时间点

segments 数据结构

参数名称	类型	描述
startTime	Number	最近开始时间点，单位毫秒
endTime	Number	最近结束时间点，单位毫秒

censorLabels 数据结构

参数名称	类型	描述
code	String	审核标签code

语音识别检测结果

asr 数组数据结构

参数名称	类型	描述
taskId	String	唯一标识
details	json数组	语音识别检测结果

details 数据结构

参数名称	类型	描述
startTime	Number	断句开始时间点，单位毫秒
endTime	Number	断句结束时间点，单位毫秒
content	String	语音识别结果

语种检测结果

language 数组数据结构

参数名称	类型	描述
taskId	String	唯一标识
details	json数组	语种检测结果

details 数据结构

参数名称	类型	描述
type	String	语种类型
segments	json数组	识别语种检测的音频时间点

segments 数据结构

参数名称	类型	描述
startTime	Number	最近开始时间点，单位毫秒
endTime	Number	最近结束时间点，单位毫秒

人声属性结果

voice 数组数据结构

参数名称	类型	描述
taskId	String	唯一标识
mainGander	String	音频性别建议值，male/female

响应示例

当获取到离线结果时，输出示例如下：

{
    "code":200,
    "msg":"ok",
    "result":{
        "taskId":"3286f29ca5d44198aca8d4a3f790c842",
        "status":0,
        "antispam":[
            {
                "action":2,
                "asrStatus":3,
                "taskId":"3286f29ca5d44198aca8d4a3f790c842",
                "labels":[
                    {
                        "label":400,
                        "level":2,
                        "subLabels":[
                            {
                                "subLabel":"400017",
                                "details":{
                                    "hint":[
                                        {
                                            "value":"与时聚进",
                                            "segments":[
                                                {
                                                    "startTime":0,
                                                    "endTime":4
                                                }
                                            ]
                                        }
                                    ],
                                    "hitType":30
                                }
                            }
                        ]
                    }
                ],
                "segments":[
                    {
                        "startTime":0,
                        "endTime":3,
                        "content":"一是坚持与时聚进。",
                        "label":400,
                        "level":2,
                        "hintList":[
                            "与时聚进"
                        ]
                    }
                ],
                "callback":"",
                "censorSource":2,
                "censorTime":1616398858595,
                "censorLabels":[

                ]
            }
        ],
        "language":[

        ],
        "asr":[
            {
                "taskId":"3286f29ca5d44198aca8d4a3f790c842",
                "details":[
                    {
                        "startTime":0,
                        "endTime":3,
                        "content":"一是坚持与时聚进。"
                    }
                ]
            }
        ],
        "voice":[

        ]
    }
}