文档反馈
文档反馈

创建内容安全审核任务

重要通知

网易云信新版文档中心现已正式上线!

音视频通话2.0互动直播2.0多人语音聊天室PK 直播等产品和场景方案已迁移至新版文档中心维护,欢迎体验!

创建实时音视频内容安全审核任务。

注意:内容安全审核相关服务端接口的请求结构、请求头、公共参数、字符编码均与其他服务端 API 相同,但 Content-Type 不同,此接口的 Content-Type 为 application/json。

接口请求地址

POST https://logic-dev.netease.im/livewallsolution/submit HTTP/1.1
Content-Type:application/json;charset=utf-8

请求参数

参数名称 类型 是否必选 描述
monitorUid int64 必选 内容安全审核服务加入房间时使用的 uid。请为内容安全审核服务在房间中的虚拟身份预留 uid 号段,便于其加入房间。
channelName String 必选 需要进行内容审核的音视频房间名称。
detectType Number 可选 检测类型。
  • 0:视频与音频同时检测。
  • 1:仅检测视频。
默认音频与视频同时检测,您也可以在控制台修改默认的检测类型。此参数未设置时,默认使用控制台配置的检测类型。
scFrequency Integer 可选 截图检测频率,取值范围为 1 ~ 60 秒。
默认5 秒截图检测一次,您也可以在控制台修改默认的截图检测频率。此参数未设置时,默认使用控制台配置的截图检测频率。
callback String 可选 自定义回调信息。请您根据业务情况自行设计该字段内容,成功传入后,审核结果中会原样返回该字段中传入的内容。
长度为 1 ~ 512 字节。
callbackUrl String 可选 接收内容安全审核结果的 URL。
默认情况下,审核结果以抄送形式发送至您在控制台预留的抄送地址。如果需要以回调方式接收审核结果,可以在开启审核任务时,将 callbackUrl 指定为新的回调地址。
主动回调数据接口超时时间为 2s,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。

返回参数

参数名称 类型 描述
code Number 接口调用状态,200 表示成功调用。
msg String 状态描述。
result 数组 接口返回结果。通常包含业务相关的返回结果。

result 字段说明:

参数名称 类型 描述
taskId String 本次请求数据标识,可以根据该标识查询数据最新结果。
status Number 请求结果。0:成功。1:失败。2:数据不存在。

示例

请求示例

{
    "monitorUid": 1234567,
    "channelName": "channel-name",
    "detectType": 0,
    "scFrequency": 5,
    "callbackUrl": "http://example.com/your-url"
}

正常返回示例

{
    "code": 200,
    "msg": "ok",
    "result": {
            "taskId": "*****",
            "status": 0
        }
}

错误码

此接口相关的业务错误码如下:

错误码(code) 错误信息(msg) 说明
400 REQUESET FORMAT ERROR 请求格式错误。
543 SUBMIT TASK ERROR 提交任务错误。
544 STOP TASK ERROR 停止任务错误。
547 QUERY SCREENSHOT ERROR 查询截图错误。
548 QUERY AUDIO ERROR 查询音频错误。

请输入您的建议或问题(至少5个字符,至多500个字符)

×

反馈成功

非常感谢您的反馈,我们会继续努力做得更好。