文档中心
实时语音
服务端 API
回调说明
音频流审核回调

音频流审核回调

更新时间：2024-12-25 14:32

1 描述

当开发者有音频流内容审核的需求时，在开始音频流审核任务后，将会以 POST 的形式对回调地址进行请求，获取音频流审核识别结果。当开始音频流审核任务中的 ReturnFinishInfo 参数为 1 时，审核任务结束后，会发起审核任务状态回调。

2 回调说明

请求方法：POST。

回调数据需要 UrlDecode 解码。

请求地址：请参考控制台 - 云市场 - 数美内容审核，按照页面指引，完成相关回调地址的配置。
传输协议：HTTPS/HTTP，建议使用 HTTPS。

3 回调参数

3.1 审核结果回调

公共参数	类型	描述
Event	String	回调事件，此回调返回值为 `censor_audio_v2_result`。
AppId	Int32	AppID。
Timestamp	Int64	服务器当前时间，Unix 时间戳（秒）。
Nonce	String	随机数。
Signature	String	签名，具体见检验说明。
业务参数	类型	描述
Code	Int32	返回码。 0 为成功。
Message	String	操作结果描述。
TaskId	String	审核任务的 TaskId。对应开始音频流审核中响应参数中返回的 TaskId。
ResultTaskId	String	此次回调信息的 ID。
Detail	Object	10s 片段的审核结果详情。
RiskLevel	String	风险级别（code 为 0 时存在）。开发者可以根据该值对违规片段对应的音频流和用户进行相应处理。注意：该字段将返回的 10s 音频中，风险程度最高的“风险类型列表”（比如“涉政”通常风险程度更高），具体“风险类型列表”的风险程度优先级由数美审核内部决定。 PASS：正常内容，建议直接放行。 REVIEW：可疑内容，建议人工审核。 REJECT：违规内容，建议直接拦截。
AudioText	String	10s 音频片段对应的语义文本。
AudioUrl	String	10s 音频片段的 URL。
PreAudioUrl	String	仅当开始审核任务请求的参数 ReturnPreAudio=1 时，该参数有值，表示当前违规音频片段 + 前一个音频片段的 20s 音频片段的 URL 地址。
RiskDescription	String	当前 10s 片段中，风险程度最高的违规内容的具体“风险类型列表”及细分类别。将按照详细程度分为，一级标签（例如涉政），二级标签（例如一号领导人）及三级标签（例如一号领导人语义）。注意：仅供人了解风险原因时作为参考，请勿依赖该参数的值做逻辑处理。 RiskLevel 为 PASS 时，返回 “正常”。命中自定义名单时，返回自定义名单名称。其他情况展现形式为：一级标签：二级标签：三级标签。
RiskLabel1	String	一级标签。 RiskLevel 为 PASS 时，返回 “normal”。
RiskLabel2	String	二级标签。二级标签归属于一级标签，当 riskLevel 为 PASS 时为空。
RiskLabel3	String	三级标签。三级标签归属于二级标签，当 riskLevel 为 PASS 时为空。
VadStatus	Int32	音频片段的静音状态： 0 ：静音片段。为静音片段时，其他部分字段将返回空，以实际回调内容为准。 1 ：非静音片段。
RiskDetail	Object	风险详情。将展示 10s 片段中，风险程度最高的风险信息。例如当前 10s 片段命中“色情”和“涉政”两个“风险类型列表”，后台判定“涉政”的风险程度高于“色情”，则当前将返回“涉政”相关的风险详情。
RiskSource	Int32	风险来源： 1000：无风险。 1001：音频语义。 1003：音频特征（如：音调、音色、声纹、旋律等）。
AudioText	String	10s 音频语义转译的文本。
MatchedLists	Array of Object	命中的自定义名单（由开发者联系技术支持进行配置）。
Name	String	自定义名单名称。
RiskInfoList	Array of Object	10s 音频片段中，所有存在风险的信息列表。按照数美内部自定义的风险程度优先级，由大到小进行排序。
RiskLevel	Int32	风险级别（code 为 0 时存在）。开发者可以根据该值对违规片段对应的音频流和用户进行相应处理。 PASS：正常内容，建议直接放行。 REVIEW：可疑内容，建议人工审核。 REJECT：违规内容，建议直接拦截。
RiskDescription	String	当前 10s 片段中，风险程度最高的违规内容的具体“风险类型列表”及细分类别。将按照详细程度分为，一级标签（例如涉政），二级标签（例如一号领导人）及三级标签（例如一号领导人语义）。注意：仅供人了解风险原因时作为参考，请勿依赖该参数的值做逻辑处理。 RiskLevel 为 PASS 时，返回 “正常”。命中自定义名单时，返回自定义名单名称。其他情况展现形式为：一级标签：二级标签：三级标签。
RiskLabel1	String	一级标签。 RiskLevel 为 PASS 时，返回 “normal”。
RiskLabel2	String	二级标签。二级标签归属于一级标签，当 riskLevel 为 PASS 时为空。
RiskLabel3	String	三级标签。三级标签归属于二级标签，当 riskLevel 为 PASS 时为空。
RiskDetail	Object	风险详情，将展示 10s 片段中，风险程度最高的风险信息。例如当前 10s 片段命中“色情”和“涉政”两个“风险类型列表”，后台判定“涉政”的风险程度高于“色情”，则当前将返回“涉政”相关的风险详情。
RiskSource	Int32	风险来源： 1000：无风险。 1001：音频语义。 1003：音频特征（如：音调、音色、声纹、旋律等）。
AudioText	String	10s 音频语义转译的文本。仅风险程度最高的风险信息此字段有值。
MatchedLists	Array of Object	命中的自定义名单（由开发者联系技术支持进行配置）。
Name	String	自定义名单名称。
BusinessInfoList	Array of Object	所有业务信息列表。若以下字段无法满足您的需求，可联系技术支持进行调整。
BusinessDescription	String	业务标签中文描述。格式为"一级业务标签:二级业务标签:三级业务标签"的中文名称，如人像:人像姿态:坐姿。
BusinessLabel1	String	一级业务标签。
BusinessLabel2	String	二级业务标签。
BusinessLabe3	String	三级业务标签。
AuxInfo	Object	辅助信息。
RoomId	String	审核的房间 ID。
ProcessBeginTime	Int64	10s 音频开始审核的时间（13 位 Unix 时间戳）。
ProcessFinishTime	Int64	10s 音频结束审核的时间（13 位 Unix 时间戳）。

3.2 审核任务状态回调

当开始音频流审核任务中的 ReturnFinishInfo 参数为 1 时，音频流审核任务结束后，会发起审核任务状态回调。

公共参数	类型	描述
Event	String	回调事件，此回调返回值为 `censor_audio_v2_status`。
AppId	Int32	AppID。
Timestamp	Int64	服务器当前时间，Unix 时间戳（秒）。
Nonce	String	随机数。
Signature	String	签名，具体见检验说明。
业务参数	类型	描述
Code	Int32	返回码，0 表示成功。
Message	String	操作结果描述。
TaskId	String	审核任务的 TaskId，对应开始音频流审核返回的 TaskId。
Status	Int32	审核状态。 0：审核结束。
AuxInfo	Object	辅助信息。
RoomId	String	房间 ID。
CensorStreamTime	Int64	本次任务审核流的总时长（单位：秒）。

4 数据示例

4.1 审核结果回调示例

{
    //公共参数
    "Event": "censor_audio_v2_result",
    "AppId": 1,
    "Timestamp": 1724743250,
    "Nonce": "7407715855877898783",
    "Signature": "5cc9e67af0ba0c95f99bd73f79a36485f574ad11"
    //业务参数
    "Code": 0,
    "Message": "success",
    "TaskId": "384a8a77aeb352d3ec8144ab4640cc52",
    "ResultTaskId": "384a8a77aeb352d3ec8144ab4640cc52_2",
    "Detail": {
        "RiskLevel": "REJECT",
        "AudioText": "病毒肺炎，香港台湾国民党，习x平，毛主",
        "AudioUrl": "http://xxxx/POST_AUDIOSTREAM%2FMP3%2F20240606%2F384a8a77aeb352d3ec8144ab4640cc52_2.mp3?Expires=1720269317&OSSAccessKeyId=LTAI5tLsVBxJ8nhyy5gQVW3K&Signature=8JZymbV%2F6Psm72k6S2Xq3Dcrg14%3D",
        "PreAudioUrl": "http://xxxx/POST_AUDIOSTREAM%2FMP3%2F20240606%2F384a8a77aeb352d3ec8144ab4640cc52_2_pre.mp3?Expires=1720269317&OSSAccessKeyId=LTAI5tLsVBxJ8nhyy5gQVW3K&Signature=BKUDNNWPklQldaEMSFOvSts6O84%3D",
        "RiskDescription": "涉政:一号领导:一号领导语义",
        "RiskLabel1": "politics",
        "RiskLabel2": "yihaolingdao",
        "RiskLabel3": "yihaolingdaoyuyi",
        "VadStatus": 1,
        "RiskDetail": {
            "RiskSource": 1001,
            "AudioText":  "病毒肺炎，香港台湾国民党，习x平，毛主",
            "MatchedLists": null
        },
        "RiskInfoList": [
            {
                "RiskLevel": "REJECT",
                "RiskDescription": "涉政:一号领导:一号领导语义",
                "RiskLabel1": "politics",
                "RiskLabel2": "yihaolingdao",
                "RiskLabel3": "yihaolingdaoyuyi",
                "RiskDetail": {
                    "RiskSource": 1001,
                    "AudioText": "病毒肺炎，香港台湾国民党，习x平，毛主",
                    "MatchedLists": null
                }
            },
            {
                "RiskLevel": "REJECT",
                "RiskDescription": "涉政:反动分裂:台独事件",
                "RiskLabel1": "politics",
                "RiskLabel2": "fandongfenlie",
                "RiskLabel3": "taidushijian",
                "RiskDetail": {
                    "RiskSource": 1001,
                    "AudioText": "",
                    "MatchedLists": null
                }
            }, 
        ],
        "BusinessInfoList": [
            {
                "BusinessDescription": "语种:普通话:普通话",
                "BusinessLabel1": "language",
                "BusinessLabel2": "Chinese",
                "BusinessLabel3": "Chinese"
            }
        ]
    },
    "AuxInfo": {
        "RoomId": "room_1",
        "ProcessBeginTime": 1717677317155,
        "ProcessFinishTime": 1717677317554
    },
}

4.2 审核任务状态回调示例

{
    //公共参数
    "Event": "censor_audio_v2_status",
    "AppId": 1,
    "Timestamp": 1724743250,
    "Nonce": "7407715855877898783",
    "Signature": "5cc9e67af0ba0c95f99bd73f79a36485f574ad11"
    //业务参数
    "Code": 0,
    "Message": "success",
    "TaskId": "384a8a77aeb352d3ec8144ab4640cc52",
    "Status": 0,
    "AuxInfo": {
        "RoomId": "room_1",
        "CensorStreamTime": 31
    }
}

5 返回响应

返回 HTTP status code 为 2XX （例如 200）表示成功，其他响应都表示失败。

6 回调重试策略

如果 ZEGO 服务器没有收到响应，或收到的 HTTP status code 不为 2XX（例如 200），都会尝试重试，最多进行 5 次重试。每次重试请求与上一次请求的间隔时间分别为 2s、4s、8s、16s、32s。若第 5 次重试后仍然失败，将不再重试，该回调丢失。