文档中心
数美内容审核
回调说明
视频流审核回调

视频流审核回调

更新时间：2024-07-08 15:12

1 描述

当开发者有视频流内容审核的需求时，在开始视频流审核功能后，ZEGO 将会以 POST 的形式对开发者提供的回调地址进行请求，以便于开发者获取视频流审核识别结果。如何发起视频流审核请参考开始视频流审核。

2 回调说明

请求方法：POST。
- 回调数据需要 UrlDecode 解码。
- 使用 POST 请求方法传递参数时：
  - Body 中的参数直接传 JsonObject 格式即可，无需序列化为 String 格式。
  - Headers 中，设置 “Content-type” 为 “application/json”。

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

3 回调参数

公共参数	类型	描述
event	String	回调事件，此回调返回值为 `censor_video`。
appid	String	AppId。
timestamp	Int64	服务器当前时间，Unix 时间戳（秒）。
nonce	String	随机数。
signature	String	签名，具体见检验说明。
业务参数	类型	描述
Code	Int32	返回码。 1100：成功。 1902：参数不合法。 1903：服务失败。 9100：余额不足。 9101：无权限操作或 accessKey 错误。
Message	String	返回码详情描述。
TaskId	String	任务唯一标识。
StatCode	Int32	审核状态。 0：审核中。 1：审核结束。
RiskLevel	Int32	风险级别（code 为 1100 时存在）。 0：pass，正常内容，建议直接放行。 1：review，可疑内容，建议人工审核。 2：reject，违规内容，建议直接拦截。
ContentType	Int32	用来区分音频和图片回调。 1：该回调为图片回调。 2：该回调为音频回调。
StreamId	String	开始视频流审核时输入的流 ID。
ImageDetail	Object	视频流中截帧图片风险详情，该参数在 ContentType 为 1 时有值。
RoomId	String	房间 ID。
ProcessStartTime	Int64	开始处理时间戳（毫秒）。
ProcessEndTime	Int64	检测完成时间戳（毫秒）。
RiskType	Int32	标识风险类型。 0：正常 100：涉政 200：色情 210：性感 300：广告 310：二维码 320：水印 400：暴恐 500：违规 510：不良场景 530：行业违规 700：自定义敏感词黑名单 710：自定义敏感词白名单 800：高危账号 900：自定义
RiskSource	Int32	风险来源。 1000：无风险。 1001：文字有风险（OCR 图片识别文字）。 1002：截帧有风险。
MatchedDetail	String	命中所有敏感词名单的详情。调用开始视频流审核时，如果 ImageType[] 传值包括 5（广告识别）、10（OCR），会触发敏感词识别。
MatchedItem	String	命中的具体敏感词。
MatchedList	String	命中敏感词所在的名单名称。
Description	String	策略规则风险原因描述。
DetectType	Int32	截帧图片是否通过检测。 1：通过检测。 2：未通过检测。
Similarity	Float	与上一张截帧图片的相似概率值，取值范围 [0, 1]，数值越接近 1，表示越相似。
StillTime	Int64	展示静止画面时间（秒），当 ImageType[] 传值包括 “9：行业违规识别” 时有返回值。
ImageUrl	String	截帧图片 URL 地址。
ImageTime	Int64	视频流截帧图片违规发生的时间戳（毫秒）。
ImageText	String	视频中画面识别出的文字内容。
AudioDetail	Object	音频流中截帧图片风险详情，该参数在 ContentType 为 2 时有值。
RoomId	String	房间 ID。
ProcessStartTime	Int64	开始处理时间戳（毫秒）。
ProcessEndTime	Int64	检测完成时间戳（毫秒）。
RiskType	Int32	视频中音频的标识风险类型。 0：正常 100：涉政 120：国歌 200：色情 210：辱骂 250：娇喘 300：广告 700：自定义敏感词黑名单 900：自定义
RiskSource	Int32	风险来源。 1000：无风险。 1001：文字有风险（ASR 语音识别文字）。 1003：音频有风险，例如娇喘、国歌音乐、声纹等。
MatchedDetail	String	命中所有敏感词名单的详情。
MatchedItem	String	命中的具体敏感词。
MatchedList	String	命中敏感词所在的名单名称。
IsSing	Int32	是否存在唱歌片段。
Description	String	策略规则风险原因描述。
VadCode	Int32	静音状态。 0：静音片段。 1：非静音片段。
AudioUrl	String	视频流中音频流片段的 URL 地址。
AudioText	String	视频中音频识别出的文字内容。
AudioStartTime	Int64	视频流中音频违规内容开始时间戳（毫秒）。
AudioEndTime	Int64	视频流中音频违规内容结束时间戳（毫秒）。
Hits	Array of Object	违规内容命中的规则标识、风险原因、风险等级和风险得分。 Hits 是命中的所有风险，请勿依赖此参数，建议取外层的 RiskLevel、Description 结合使用。
Description	String	违规内容命中的风险原因描述。
Model	String	违规内容命中的规则标识。
RiskLevel	Int32	违规内容命中的风险级别。
RiskType	Int32	违规内容命中的风险类型。
Score	Int32	违规内容命中的风险分数。
Language	Array of Object	语种识别与概率值列表。
Label	Int32	语种识别类别标识。 0：普通话 1：英语 2：粤语
Probability	Int32	对应语种标签可能性大小，取值 [0, 100]，数值越高表示概率越大。

4 数据示例

视频审核-截帧图片

{
    "event": "censor_video",
    "appid": "1",
    "timestamp": 1499676978,
    "nonce": "350176",
    "signature": "signature",
    "Code": 1100,
    "Message": "成功",
    "TaskId": "5a6b1eafad4a46d031ebfe92d8ce07b8_vs18_1636362107248428906",
    "StatCode": 0,
    "RiskLevel": 2,
    "ContentType": 1,
    "StreamId": "webrtc1646126217146",
    "ImageDetail": {
        "RoomId": "demo",
        "ProcessStartTime": 1636362107248,
        "ProcessEndTime": 1636362107376,
        "RiskType": 100,
        "RiskSource": 1002,
        "MatchedDetail": "",
        "MatchedItem": "",
        "MatchedList": "",
        "Description": "涉政：一号领导：一号领导",
        "DetectType": 1,
        "Similarity": 0.93333334,
        "StillTime": 0,
        "ImageUrl": "http://xxx.jpg?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDcCe4LVKKzUvBIEtb2NZbS8lGblkbmoFW%26q-sign-time%3D1636362107%3B1638954107%26q-key-time%3D1636362107%3B1638954107%26q-header-list%3D%26q-url-param-list%3D%26q-signature%3Db116faf3d084819f0ff05ac04d73d041881033e1",
        "ImageTime": 1636362107250,
        "ImageText": ""
    },
    "AudioDetail": null
}

视频审核-音频

{
    "event": "censor_video",
    "appid": "1",
    "timestamp": 1499676978,
    "nonce": "350176",
    "signature": "signature",
    "Code": 1100,
    "Message": "成功",
    "TaskId": "bb609fcf9c4280f22328c137f1187119_3",
    "StatCode": 0,
    "RiskLevel": 2,
    "ContentType": 2,
    "StreamId": "webrtc1646126217146",
    "ImageDetail": null,
    "AudioDetail": {
        "RoomId": "demo",
        "ProcessStartTime": 1636361928212,
        "ProcessEndTime": 1636361928928,
        "RiskType": 100,
        "RiskSource": 1001,
        "MatchedDetail": "",
        "MatchedItem": "xxx",
        "MatchedList": "涉政_核心领导_xxx",
        "IsSing": 0,
        "Description": "涉政：核心领导：xxx",
        "VadCode": 1,
        "AudioUrl": "https://xxx.mp3?q-sign-algorithm=sha1&q-ak=AKIDcCe4LVKKzUvBIEtb2NZbS8lGblkbmoFW&q-sign-time=1636361928%3B1638953928&q-key-time=1636361928%3B1638953928&q-header-list=host&q-url-param-list=&q-signature=dda2d7fa2d55ba166ac3978227137e060beaf03c",
        "AudioText": "xxx",
        "AudioStartTime": 0,
        "AudioEndTime": 0,
        "Hits": [
            {
                "Description": "涉政：核心领导：xxx",
                "Model": "MA000001002001001",
                "RiskLevel": 2,
                "RiskType": 100,
                "Score": 980
            }
        ],
        "Language": []
    }
}

5 返回响应

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

6 回调重试策略

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