如果您在提交语音流检测任务时没有设置callback地址,则您需要调用本接口轮询检测结果。

描述

业务接口/green/voice/results

每次轮询会返回最近3分钟的语音检测结果。建议您将查询间隔设置为30秒。

关于scene与label参数

在提交检测任务时,您需要指定scenes场景参数;而在检测返回结果中,则包含与您指定的场景对应的label结果分类参数。

在语音反垃圾中,scene与label的对应关系如下:
场景 描述 scene label
语音检测 识别语音文件中的违规信息。
说明 默认识别语言为中文。
antispam
  • normal 正常
  • spam:含垃圾信息
  • ad:广告
  • politics:涉政
  • abuse:辱骂
  • porn:色情
  • contraband:违禁
  • customized:用户自定义词库

请求参数

关于在请求中必须包含的公共请求参数,请参考公共参数

请求body是一个JSON数组,字段说明如下:
名称 类型 是否必需 描述
body JSON数组 要查询的taskId列表,最大长度不超过100。

返回参数

返回结果说明,参见返回结果

返回body中的Data字段是JSON数组,每一个元素包含如下字段:
名称 类型 是否必需 描述
code 整形 错误码,和HTTP的status code一致。
  • 200:表示检测成功。
  • 280:表示处理中,需要继续轮询。
  • 其他:表示任务失败。
说明 只有返回 280表示任务还在进行,需要继续轮询该任务的检测结果。返回其他值均表示该语音流检测已结束;如果实际上该语音流没有结束,而是因为网络异常等情形结束了,您可以重新提交语音流检测任务。
msg 字符串 错误描述信息。
dataId 字符串 对应的请求中的dataId
taskId 字符串 该检测任务的ID。
url 字符串 对应的请求中的URL。
results JSON数组 检测成功时(code = 200)返回的检测结果。该结果包含一个或多个元素,每个元素是个结构体,对应一个场景。每个元素的具体结构描述见result
表 1. result
名称 类型 是否必需 描述
scene 字符串 检测场景,和调用请求中的场景对应。
label 字符串 检测结果的分类,与具体的scene对应。取值范围参考scene 和 label说明
suggestion 字符串 建议您执行的操作,取值:
  • pass:内容不违规,建议放行
  • review:不确定,需要进行人工审核
  • block:内容违规,建议隔离
rate 浮点数 结果为该分类的概率,取值范围为[0.00-100.00]。值越高,表示越有可能属于该分类。

分值仅供参考,您需要关注labelsuggestion内容。

details JSON数组 语音对应的文本详情。每一句文本对应一个元素,包含一个或者多个元素,每个元素的具体结构见detail
表 2. detail
名称 类型 是否必需 描述
startTime 整型 句子开始的时间,单位是秒。
endTime 整型 句子结束的时间,单位是秒。
text 字符串 语音转换成文本的结果。
label 字符串 检测结果的分类,与具体的scene对应。取值范围参考scene 和 label说明
keyword 字符串 如果了命中用户自定义关键词,返回命中的关键词。
libName 字符串 如果了命中用户自定义关键词,返回关键词所在的词库。

示例

请求示例
[
	"taskId1",
	"taskId2"
]
返回示例
{
    "code":200,
    "msg":"OK",
    "requestId":"AD87F1D1-A675-4F82-8D67-ED43B6FFA876",
    "data":[
        {
            "code":280,
            "msg":"running",
            "dataId":"some dataId",
            "taskId":"taskId1",
            "url":"http://foo.com/sample/a.mp3",
            "results":[
                {
                    "scene":"antispam",
                    "label":"customized",
                    "suggestion":"block",
                    "rate":99.91,
                    "details":[
                        {
                            "startTime":0,
                            "endTime":24,
                            "text":"blabla...",
                            "label":"customized"
                        },
                        {
                            "startTime":24,
                            "endTime":60,
                            "text":"blabla...",
                            "label":"normal"
                        }
                    ]
                }
            ]
        },
        {
            "code":280,
            "msg":"running",
            "dataId":"some dataId",
            "taskId":"taskId2",
            "url":"http://foo.com/sample/b.mp3",
            "results":[
                {
                    "scene":"antispam",
                    "label":"normal",
                    "suggestion":"pass",
                    "rate":99.91,
                    "details":[
                        {
                            "startTime":0,
                            "endTime":10,
                            "text":"blabla...",
                            "label":"normal"
                        }
                    ]
                }
            ]
        }
    ]
}