直播审核接口
所有文档

          媒体内容审核 VCR

          直播审核接口

          提交直播审核

          用户提供视频路径,创建一次视频审核。

          • 支持RTMP/HTTP拉流
          • 正在审核中的直播(以直播流地址区分)无法重复发起审核

          请求语法

          PUT /v<version>/stream/check HTTP/1.1
          host: vcr.bj.baidubce.com
          authorization: <bce-authorization-string>
          x-bce-date: <bce-authorization-utc-date>
          content-type: application/json

          请求参数

          请求体

          参数 类型 描述 是否必须
          source String 直播流地址,支持RTMP/HTTP拉流 是,长度不超过1024
          preset String 审核模板名称
          notification String 通知名称
          description String 视频描述,默认为空字符串,不超过256字符
          notifyLevel String 通知等级(NORMAL/REVIEW/REJECT),默认REVIEW
          thumbnailInterval Float 抽帧间隔,>=1s,默认为1s
          audioInterval Integer 抽音频间隔,>=10s,默认为30s

          请求示例

          PUT /v2/stream/check HTTP/1.1
          host: vcr.bj.baidubce.com
          authorization: <bce-authorization-string>
          x-bce-date: 2015-04-27T08:23:49Z
          content-type: application/json
          
          {
            "source": "http://xxx/xxx.m3u8",
            "notification": "vcr_callback",
            "preset": "default",
            "notifyLevel": "NORMAL",
            "thumbnailInterval": 1,
            "audioInterval": 30
          } 

          响应体

          响应示例

          HTTP/1.1 200 OK

          查询直播流审核状态

          查询某条直播流的审核状态。

          请求语法

          GET /v2/stream HTTP/1.1
          host: vcr.bj.baidubce.com
          authorization: <bce-authorization-string>
          x-bce-date: <bce-authorization-utc-date>
          content-type: application/json

          请求参数

          参数 类型 描述 是否必须
          source String 直播流地址

          说明:

          参数均需要经过urlEncode。

          请求体

          请求示例

          GET /v2/stream?source=http://xxx/xxx.m3u8 HTTP/1.1
          host: vcr.bj.baidubce.com
          authorization: <bce-authorization-string>
          x-bce-date: 2015-04-27T08:23:49Z
          content-type: application/json

          响应头域

          响应参数

          参数 类型 描述
          source String 直播流地址
          status String 直播流当前状态,可选值:PROVISIONING/PROCESSING/FINISHED/ERROR
          notification String 通知名称
          error Object 错误信息,仅status=ERROR时存在
          + code String 错误码
          + message String 错误消息
          createTime Date 直播审核创建时间
          startTime Date 直播审核开始时间
          finishTime Date 直播审核完成时间,仅status=FINISHED/ERROR时存在
          duration Integer 审核持续时长,单位:秒
          streamId String 直播审核任务ID
          mediaId String 直播流ID
          description String 描述信息
          streamParams Object 直播审核参数
          +preset String 审核模板名称
          +notifyLevel String 通知等级(NORMAL/REVIEW/REJECT)
          +thumbnailInterval Float 抽帧间隔
          +audioInterval Integer 抽音频间隔

          响应示例

          HTTP/1.1 200 OK
          {
              "createTime": "2019-10-08T09:12:01Z",
              "description": "",
              "duration": 524,
              "finishTime": "2019-10-08T09:20:50Z",
              "mediaId": "c084a221c7xxxxx69f58xxxx8d",
              "notification": "vcr_callback",
              "source": "http://xxx/xxx.m3u8",
              "startTime": "2019-10-08T09:12:05Z",
              "status": "FINISHED",
              "streamId": "jj7qcgkaep1c4ya1iev",
              "userId": "d1xxxx5f431xxxx74b6****8",
              "streamParams": {
                  "audioInterval": 30,
                  "notifyLevel": "NORMAL",
                  "preset": "default",
                  "thumbnailInterval": 1.0
              }
          }

          直播流审核列表页

          可以根据状态查询直播流的列表页。

          请求语法

          GET /v2/stream/list HTTP/1.1
          host: vcr.bj.baidubce.com
          authorization: <bce-authorization-string>
          x-bce-date: <bce-authorization-utc-date>
          content-type: application/json

          请求参数

          参数 类型 描述 是否必须
          maxKeys Integer 本次请求返回的任务列表的最大元素个数,合法取值范围为[1-100],默认值为10 否,默认为10
          marker String 本次请求的marker,标记查询的起始位置,是上次marker机制查询返回的nextMarker,首次查询不提供本字段
          status String 直播流状态

          请求体

          请求示例

          GET /v2/stream/list?maxKeys=10&status=PROVISIONING HTTP/1.1
          host: vcr.bj.baidubce.com
          authorization: <bce-authorization-string>
          x-bce-date: 2015-04-27T08:23:49Z
          content-type: application/json

          响应体

          响应参数

          参数 类型 描述
          maxKeys Integer 本次请求返回的任务列表的最大元素个数,合法取值范围为[1-100],默认值为10
          marker String 本次请求的marker,标记查询的起始位置
          nextMarker String 获取下一页所需要传递的marker值,当isTruncated为false时,该域不出现
          isTruncated Stringoolean 指明是否所有查询都返回了,true表示后面还有数据,false表示已经是最后一页
          tasks Array 任务列表
          +source String 直播流地址
          +status String 直播流当前状态,可选值:PROVISIONING/PROCESSING/FINISHED/CANCELLED/ERROR
          +notification String 通知名称
          +error Object 错误信息,仅status=ERROR时存在
          ++ code String 错误码
          ++ message String 错误消息
          +createTime Date 直播审核创建时间
          +startTime Date 直播审核开始时间
          +finishTime Date 直播审核完成时间,仅status=FINISHED/ERROR时存在
          +duration Integer 审核持续时长,单位:秒
          +streamId String 直播审核任务ID
          +mediaId String 直播流ID
          +description String 描述信息
          +streamParams Object 直播审核参数
          ++preset String 审核模板名称
          ++notifyLevel String 通知等级(NORMAL/REVIEW/REJECT)
          ++thumbnailInterval Float 抽帧间隔
          ++audioInterval Integer 抽音频间隔

          响应示例

          HTTP/1.1 200 OK
          {
              "maxKeys":10,
              "marker":"1",
              "nextMarker":"2",
              "isTruncated":se,
              "tasks":[{
                  "createTime":"2019-10-08T09:12:01Z",
                  "description":"",
                  "duration":524,
                  "finishTime":"2019-10-08T09:20:50Z",
                  "mediaId":"c084a2xxxxc7de04xxxxf583b78d",
                  "notification":"vcr_callback",
                  "source":"http://xxx/xxx.m3u8",
                  "startTime":"2019-10-08T09:12:05Z",
                  "status":"FINISHED",
                  "streamId":"jj7qcgkaep1c4ya1iev",
                  "userId":"d1953xxxxaa9xxxx174b6****8",
                  "streamParams":{
                      "audioInterval":30,
                      "notifyLevel":"NORMAL",
                      "preset":"default",
                      "thumbnailInterval":1
                  }
              }]
          }

          取消直播流审核

          取消正在进行的直播审核任务。

          请求语法

          PUT /v2/stream/cancel HTTP/1.1
          host: vcr.bj.baidubce.com
          authorization: <bce-authorization-string>
          x-bce-date: <bce-authorization-utc-date>
          content-type: application/json    

          请求参数

          请求体

          参数 类型 描述 是否必须
          source String 直播流地址,支持RTMP/HTTP拉流 是,长度不超过1024
          notification String 通知名称

          请求示例

          PUT /v2/stream/cancel HTTP/1.1
          host: vcr.bj.baidubce.com
          authorization: <bce-authorization-string>
          x-bce-date: 2015-04-27T08:23:49Z
          content-type: application/json
          
          {
            "source": "http://xxx/xxx.m3u8",
            "notification": "vcr_callback"
          }

          响应体

          响应示例

          HTTP/1.1 200 OK

          直播流审核结果回调格式

          通知结果使用POST请求进行回调。

          参数说明

          参数 类型 描述
          messageId String 回调消息ID
          messageBody String 回调消息内容Body(json)

          回调结果示例

          {
          	"messageId":"086c404f-407a-4dd5-882b-e85639b00169",
          	"messageBody":"******"
          }

          messageBody有下面两种类型。

          直播流图片/音频结果回调

          参数说明

          参数 类型 描述
          source String 直播流地址
          preset String 审核模板名称
          notification String 通知名称
          mediaId String 直播流ID
          evidenceTime Date 审核证据出现时间
          description String 视频描述,默认为空字符串,不超过256字符
          audioUrl String 直播流抽出音频的地址,只有音频审核结果中有
          thumbnailUrl String 直播流抽出图片的地址,只有图片审核结果中有
          label String 审核结果标签:NORMAL/REVIEW/REJECT
          results Array 审核结果信息

          示例

          {
              "evidenceTime":"2019-10-09T13:24:32Z",
              "audioUrl":"http://xxxx/vcr-evidence/xxx/xxxxx/mid/xxxx.pcm?authorization=bce-auth-v1%2Fxxxxx%2F2019-10-09T13%3A14%3A31Z%2F3600%2Fhost%2F2534211eaaf6xxxxxxd2f64d017b9049ab6c08xxxxxx159d9724eec",
              "results":[
                  {
                      "type":"sexual_porn",
                      "items":[
                          {
                              "subType":"behavior",
                              "target":"audio",
                              "startTimeInSeconds":0,
                              "endTimeInSeconds":3,
                              "confidence":84.19,
                              "label":"REJECT"
                          },
                          {
                              "subType":"behavior",
                              "target":"audio",
                              "startTimeInSeconds":10,
                              "endTimeInSeconds":14,
                              "confidence":95.58,
                              "label":"REJECT"
                          },
                          {
                              "subType":"behavior",
                              "target":"audio",
                              "startTimeInSeconds":28,
                              "endTimeInSeconds":30,
                              "confidence":99.98,
                              "label":"REJECT"
                          }
                      ]
                  }
              ],
              "source":"http://xxx/xxx.m3u8",
              "preset":"default",
              "description":"",
              "notification":"vcr_callback",
              "mediaId":"8957357bxxxxe7857ea39axxxx57de2",
              "label":"REJECT"
          }

          直播流结束回调

          参数说明

          参数 类型 描述
          source String 直播流地址
          preset String 审核模板名称
          notification String 通知名称
          mediaId String 直播流ID
          createTime Date 审核任务创建时间
          finishTime Date 审核任务结束时间
          description String 描述信息
          status String 审核任务状态:FINISHED

          示例

          {
              "source":"http://xxx/xxx.m3u8",
              "preset":"default",
              "description":"",
              "notification":"vcr_callback",
              "mediaId":"d5b8xxxbf10551abc76xxxx3ea104e",
              "createTime":"2019-10-09T13:19:37Z",
              "finishTime":"2019-10-09T13:37:12Z",
              "status":"FINISHED"
          }

          审核结果说明

          审核结果

          审核结果格式为:

          参数 类型 描述
          label String 审核结果标记,可选值:NORMAL/REVIEW/REJECT
          results Array 审核结果
          + type String 子审核类型
          + items Array 审核结果项数组

          审核标记

          审核结果标记label,简称审核标记,其可选值包括NORMAL/REVIEW/REJECT,分别表示正常/疑似/拒绝。

          审核标记是根据 VCR 审核结果的置信度和用户审核视频时指定的审核模板中疑似阈值和拒绝阈值(审核模板目前仅允许VCR内部为用户配置)生成的。

          举个例子,VCR在对视频图像进行审核时,判断某一帧为色情图片的置信度为C,用户使用的审核模板中配置的疑似阈值和拒绝阈值分别为T_ReviewT_Reject

          • C < T_Review,VCR忽视该帧图片的色情审核结果;
          • T_Review <= C < T_Reject,VCR输出一个label=REVIEW的审核结果项;
          • T_Reject <= C,VCR会输出一个label=REJECT的审核结果项。

          视频的审核结果标记由各审核结果项(见下)汇总得到,汇总规则:

          • 审核结果数组为空,即没有审核结果项时视频label = NORMAL
          • 任一审核结果项label = REJECT时,视频label = REJECT
          • 其余情况下(所有审核结果项label = REVIEW)视频label = REVIEW

          审核维度/审核物料

          VCR 会对视频中多个审核维度进行审核,审核维度也称为审核物料。VCR 提取视频中下列物料进行审核:

          • thumbnail,以一定策略从视频截取的缩略图;
          • audio,视频音频;
          • speech,视频音频通过ASR技术获取的语音识别结果;
          • character,视频缩略图通过OCR技术获取的文字识别结果。

          子审核类型

          审核结果中的type表示”子审核类型”,对应在审核场景中提及的各项子审核。每类审核场景在不同的审核维度上,包含一个或多个子审核类型,并且随着智能内容审核服务的迭代升级,会不断扩展审核场景和子审核类型。

          VCR视频审核目前提供下列子审核类型:

          审核场景 子审核类型 描述 支持的审核物料类型
          色情审核 porn 色情审核 thumbnail,audio,character,speech
          色情审核 sexy 性感审核 thumbnail
          暴恐审核 terrorism 暴恐审核 thumbnail,speech,character
          涉政审核 politician 涉政人物审核 thumbnail,character,speech
          涉政审核 politician 自定义人脸库审核 thumbnail
          涉政审核 politics 涉政事件或涉政机构审核 character,speech
          广告审核 ad_qrcode 二维码广告审核 thumbnail
          广告审核 ad_barcode 条形码广告审核 thumbnail
          广告审核 ad_text 文本广告审核 character,speech
          广告审核 ad_logo logo审核 thumbnail
          广告审核 ad_logo 自定义logo库审核 thumbnail
          违禁审核 illegal 违禁品审核 character,speech

          VCR视频审核最新的子审核类型如下:

          审核场景 子审核类型 描述 支持的审核物料类型
          色情审核 sexual_porn 色情审核 thumbnail,audio,character,speech
          色情审核 sexual_sexy 性感审核 thumbnail
          色情审核 sexual_intimacy 亲密行为审核 thumbnail
          色情审核 sexual_vulgar 低俗审核 thumbnail
          暴恐审核 terrorist_group 恐怖组织审核 thumbnail,speech,character
          暴恐审核 terrorist 暴恐人物审核 thumbnail,speech,character
          暴恐审核 terror_event 暴力事件审核 thumbnail,speech,character
          涉政审核 politician 涉政人物审核 thumbnail,character,speech
          涉政审核 political_event 涉政事件审核 character,speech
          涉政审核 political_group 涉政组织审核 thumbnail,character,speech
          广告审核 ad_brand 品牌广告审核 thumbnail,character,speech
          广告审核 ad_marketing 欺诈及营销广告审核 thumbnail,character,speech
          违禁审核 illegal_gamble 赌博审核 character,speech
          违禁审核 illegal_forgery 假冒伪劣及造假盗窃审核 character,speech
          违禁审核 illegal_trade 非法交易审核 character,speech
          违禁审核 illegal_privacy 非法获取私人信息审核 character,speech

          审核结果项

          在审核结果中,每个子审核类型都对应一个items,表示该子审核的结果。数组中的元素称为审核结果项,其具体格式为:

          参数 类型 描述
          subType String 审核三级分类
          target String 审核物料类型,可选值:thumbnail, audio, speech, character
          timeInSeconds Number 物料在视频中的秒数,thumbnail/character审核物料有该属性
          startTimeInSeconds Number 物料在视频中的起始秒数,和endTimeInSeconds同时存在,audio/speech审核物料有该属性
          endTimeInSeconds Number 物料在视频中的结束秒数,和startTimeInSeconds同时存在
          confidence Double 审核结果项的置信度,0~100的浮点数
          label String 审核结果项标记
          extra String 额外信息,如有;例如涉政人物审核出来的人名
          evidence Object 审核证据

          审核证据

          根据不同的审核物料类型,审核证据也不相同。审核证据的格式为:

          参数 类型 描述
          thumbnail String 缩略图URL
          location Object 证据位置信息
          + leftOffsetInPixel Number 左偏移
          + topOffsetInPixel Number 上偏移
          + widthInPixel Number 宽度
          + heightInPixel Number 高度
          text String 文本证据

          具体地说:

          • target=thumbnail,审核证据=thumbnail +(可选)location
          • target=audio,暂无审核证据
          • target=speech,审核证据=text
          • target=character,审核证据=thumbnail + location + text

          审核结果示例

          审核结果:

          {
              "label" : "REJECT",
              "results" : [{
                  "type": "porn",
                  "items": [{
                      "target": "thumbnail",
                      "timeInSeconds": 103,
                      "confidence": 98.76,
                      "label": "REJECT",
                      "evidence": {
                          "thumbnail": "http://xxx/xxx.jpg"
                      }
                  }, {
                      "target": "audio",
                      "confidence": 70,
                      "startTimeInSeconds": 0,
                      "label": "REVIEW"
                  }, {
                      "target": "character",
                      "confidence": 69,
                      "timeInSeconds": 2,
                      "label": "REVIEW",
                      "evidence": {
                          "thumbnail": "http://xxx/xxx.jpg",
                          "location": {
                              "leftOffsetInPixel": 10,
                              "topOffsetInPixel": 10,
                              "widthInPixel": 20,
                              "heightInPixel": 20
                          },
                          "text": "这是一段文字识别的色情文字"
                      }
                  }, {
                      "target": "speech",
                      "confidence": 68,
                      "startTimeInSeconds": 0,
                      "endTimeInSeconds": 20,
                      "label": "REVIEW",
                      "evidence": {
                          "text": "这是一段语音识别的色情文字"
                      }
                  }],
              }, {
                  "type": "sexy",
                  "items": [{
                      "target": "thumbnail",
                      "timeInSeconds": 35,
                      "confidence", 68.4,
                      "label": "REVIEW",
                      "evidence": {
                          "thumbnail": "http://xxx/xxx.jpg"
                      }
                  }]
              }, {
                  "type": "terrorism",
                  "items": [{
                      "target": "character",
                      "timeInSeconds": 12,
                      "confidence": 50,
                      "label": "REVIEW",
                      "extra": "炸弹",
                      "evidence": {
                          "thumbnail": "http://xxx/xxx.jpg",
                          "location": {
                              "leftOffsetInPixel": 10,
                              "topOffsetInPixel": 10,
                              "widthInPixel": 20,
                              "heightInPixel": 20
                          },
                          "text": "炸弹是文字识别的暴恐文字"
                      }
                  }]
              }, {
                  "type": "politician",
                  "items": [{
                      "target": "thumbnail",
                      "timeInSeconds": 144,
                      "confidence": 95,
                      "label": "REJECT",
                      "extra": "习大大",
                      "evidence": {
                          "thumbnail": "http://xxx/xxx.jpg",
                          "location": {
                              "leftOffsetInPixel": 10,
                              "topOffsetInPixel": 10,
                              "widthInPixel": 20,
                              "heightInPixel": 20
                          }
                      },
                  }]
              }, {
                  "type": "politics",
                  "items": [{
                      "target": "speech",
                      "startTimeInSeconds": 2
                      "endTimeInSeconds": 10
                      "confidence": 90,
                      "label": "REJECT",
                      "extra": "天安门",
                      "evidence": {
                          "text": "天安门是语音识别的涉政文字"
                      }
                  }]
              }]
          }
          上一篇
          文本审核接口
          下一篇
          通知接口