提交语音文件检测任务后,调用本接口查询检测结果。

描述

业务接口/green/voice/results

客户端定时轮询查询异步检测结果。建议您将查询间隔设置为30秒,最长不能超过4个小时,否则结果会消失。

关于scene与label参数

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

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

请求参数

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

请求body是一个JSON数组,字段说明如下:
名称 类型 是否必需 描述
body JSON数组 JSON数组中的每个元素是一个结构体(Task表)。每个元素的具体结构描述见task
表 1. task
名称 类型 是否必需 描述
dataId String 对应异步检测请求中的dataId
taskId String 对应异步检测响应中的taskId

返回参数

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

返回消息body中的Data字段是JSON数组,每一个元素包含如下字段:
名称 类型 是否必需 描述
code int 错误码,和HTTP的status code一致。
  • 200:表示检测成功。
  • 280:表示处理中需要继续轮询。
  • 其他:表示任务任务失败。
msg String 错误描述信息。
dataId String 对应请求中的dataId
taskId String 该检测任务的ID。
results JSON数组 返回结果。调用成功时(code=200),返回结果中包含一个或多个元素。每个元素是个结构体,具体结构描述见result
表 2. result
名称 类型 是否必需 描述
scene String 检测场景,和调用请求中的场景对应。
label String 检测结果的分类,与具体的scene对应。取值范围参考scene 和 label说明
suggestion 字符串 建议用户执行的操作,取值:
  • pass
  • review
  • block
details JSON数组 语音对应的文本详情,包含一个或者多个元素。每一句文本对应一个元素,每个元素的具体结构描述见detail
表 3. detail
名称 类型 是否必需 描述
startTime long 句子开始的时间,单位为秒。
endTime long 句子结束的时间,单位为秒。
text String 语音转换成文本后的结果。
label String 检测结果的分类,与具体的scene对应。取值范围参考scene 和 label说明
keyword String 如果了命中用户自定义的关键词,返回命中的关键词。
libName String 如果了命中用户自定义的关键词,返回关键词所在的词库。

示例

请求示例
[
    {
       "taskId": "vc_f_1OsjIYTukH@4@AXkIQ9Oyh-1ov52Y",
       "dataId": "3b4b73b1-0152-4aa6-83ad-33730ba8a5e5"
   }
]
返回示例
{
    "msg":"OK",
    "code":200,
    "data":[
        {
            "code":200,
            "dataId":"3b4b73b1-0152-4aa6-83ad-33730ba8a5e5",
            "results":[
                {
                    "rate":99.91,
                    "suggestion":"block",
                    "details":[
                        {
                            "libName":"test",
                            "startTime":0,
                            "endTime":4065,
                            "label":"customized",
                            "text":"恶心的",
                            "keyword":"恶心"
                        },
                        {
                            "startTime":4430,
                            "endTime":10065,
                            "label":"normal",
                            "text":"测试,测试,哈哈哈"
                        },
                        {
                            "libName":"语音测试",
                            "startTime":11670,
                            "endTime":14685,
                            "label":"customized",
                            "text":"超低折扣,大甩卖",
                            "keyword":"甩卖"
                        },
                        {
                            "startTime":14685,
                            "endTime":16065,
                            "label":"ad",
                            "text":"微信12345"
                        },
                    ],
                    "label":"customized"
                }
            ],
            "taskId":"vc_f_1OsjIYTukH@4@AXkIQ9Oyh-1ov52Y"
        }
    ],
    "requestId":"5A7A6198-6960-4DDC-B67E-58A6F1A4B20F"
}