直播音视频解决方案直播音频查询接口

接口地址

https://as.dun.163yun.com/v1/livewallsolution/query/audio/task

接口描述

实时查询音频断句信息。建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。

接口请求频率

小于10s/20次,请求频率过快服务器会拒绝处理。

请求参数

公共参数已省略,详细见 请求公共参数

参数名称类型是否必选最大长度描述
taskIdStringY-提交音视频后返回的taskId
startTimeNumberY-查询断句起始时间
endTimeNumberY-查询断句结束时间
recordNumberN-是否返回录制文件地址,可选值0或1

startTime和endTime之间的时间差不可超过10分钟,当需要record的时候,可查范围为90天,不需要record的时候,可查范围为7天

响应结果

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

result 数组结构

参数名称类型描述
idNumber直播音频断句id
taskIdString唯一标识
actionNumber检测结果,0:通过,1:嫌疑,2:不通过
asrStatusNumber音频翻译结果,2:检测中,3:检测完成,4:检测失败
asrResultNumber音频翻译检测失败原因,1:文件格式错误,2:文件下载失败,3:解析失败,4:音频流不存在
callbackString产品调用直播语音在线检测传递的 callback 字段数据
censorSourceNumber审核来源,0:易盾人审,1:客户人审,2:易盾机审
speakerIDString针对接入SDK监听客户,可能返回的说话人ID信息
startTimeNumber最近开始时间点,单位毫秒
endTimeNumber最近结束时间点,单位毫秒
segmentsjson数组证据信息,通过时数据为空
recordsjson数组录制信息

其中 segments 结构如下:

参数名称类型描述
labelNumber分类信息,100:色情,200:广告,300:暴恐,400:违禁,500:涉政,600:谩骂
levelNumber分类级别,0:正常,1:不确定,2:确定
evidneceString命中的敏感词或者声纹检测的分值

records 结构如下:

参数名称类型描述
startTimeNumber最近开始时间点,单位毫秒
endTimeNumber最近结束时间点,单位毫秒
urlString录制地址

请求示例

    /** 产品密钥ID,产品标识 */
    private final static String SECRETID = "your_secret_id";
    /** 产品私有密钥,服务端生成签名信息使用,请严格保管,避免泄露 */
    private final static String SECRETKEY = "your_secret_key";
    /** 易盾反垃圾云服务直播音视频解决方案在线提交接口地址 */
    private final static String API_URL = "https://as.dun.163yun.com/v1/livewallsolution/query/audio/task";
    /** 实例化HttpClient,发送http请求使用,可根据需要自行调参 */
    private static HttpClient httpClient = HttpClient4Utils.createHttpClient(100, 20, 2000, 2000, 2000);

    /**
     *
     * @param args
     * @throws Exception
     */
    public static void main(String[] args) throws Exception {
        Map<String, String> params = new HashMap<String, String>();
        // 1.设置公共参数
        params.put("secretId", SECRETID);
        params.put("version", "v1.0");
        params.put("timestamp", String.valueOf(System.currentTimeMillis()));
        params.put("nonce", String.valueOf(new Random().nextInt()));

        // 2.设置私有参数
        params.put("taskId", "xxxx");
        params.put("startTime", "xxxx");
        params.put("endTime", "xxxx");
        params.put("record", "0");
                
        // 3.生成签名信息
        String signature = SignatureUtils.genSignature(SECRETKEY, params);
        params.put("signature", signature);

        // 4.发送HTTP请求,这里使用的是HttpClient工具包,产品可自行选择自己熟悉的工具包发送请求
        String response = HttpClient4Utils.sendPost(httpClient, API_URL, params, Consts.UTF_8);

        // 5.解析接口返回值
        JsonObject jObject = new JsonParser().parse(response).getAsJsonObject();
            int code = jObject.get("code").getAsInt();
            String msg = jObject.get("msg").getAsString();
            JsonArray resultArray = jObject.get("result").getAsJsonArray();
            if (code == 200) {
                for (int i = 0; i < resultArray.size(); i++) {
                    JsonObject result = resultArray.get(i).getAsJsonObject();
                    String taskId = result.get("taskId").getAsString();
                    System.out.println(result.toString());
                }
            }
        }

响应示例

{
    "code": 200,
    "msg": "ok",
    "result": [
        {
            "taskId":"5473fbabe7774dbc9cc80e12d60f6fb6",
            "action":2,
            "asrStatus":3,
            "callback":"",
	    "censorSource":"2",
	    "speakerID":"10096",
            "startTime":1584415110890,
            "endTime":1584415115720,
            "segments":[
                {
                    "label":400,
                    "level":2,
                    "evidence":"(我+你)"
                }
            ],
            "records":[
                {
                    "startTime":1584415091830,
                    "endTime":1584415111830,
                    "url":"https://yidun-antispam.nos-eastchina1.126.net/5473fbabe7774dbc9cc80e12d60f6fb6_1584415091830.mp3?Signature=9lVvAIpjHF7lsJNhzuH4FrgebpfZGwiotjBCa%2FdfTq4%3D&Expires=1585330675&NOSAccessKeyId=a681ebcbcd5646a488d275c33acb16bd"
                }
            ]
        }
    ]
}