直播审核接口

更新时间：2021-10-28

提交直播审核

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

支持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_Review和T_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表示”审核类型”。每类审核场景下包含着多种审核类型，不同审核类型支持的审核物料也不一样。随着智能内容审核服务的迭代升级，会不断扩展审核场景和审核类型。

审核类型列表

审核场景	子审核类型	描述	支持的审核物料类型
色情审核	sexual_porn	色情审核	thumbnail,audio,character,speech
色情审核	sexual_sexy	性感审核	thumbnail
色情审核	sexual_intimacy	亲密行为审核	thumbnail
色情审核	sexual_vulgar	低俗审核	thumbnail
涉黄审核	sexual_special	特殊行为	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
违禁审核	bad_behavior	不良行为审核	thumbnail
违禁审核	illegal_gamble	赌博审核	character,speech
违禁审核	illegal_forgery	假冒伪劣及造假盗窃审核	character,speech
违禁审核	illegal_trade	非法交易审核	character,speech
违禁审核	illegal_privacy	非法获取私人信息审核	character,speech
质量审核	disgust	恶心审核	thumbnail

审核结果项

在审核结果中，每个子审核类型都对应一个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	审核证据

审核项

审核结果中的subType表示”审核项”。每种审核类型下细分了不同审核项。

审核项列表

审核场景	审核类型	审核项	审核项描述
涉黄审核	sexual_porn	behavior,sm,products,children,art	性行为及露点及招嫖,SM,性用品及性玩具,儿童,艺术品色情
涉黄审核	sexual_sexy	male,female	男性衣着暴露,女性衣着暴露
涉黄审核	sexual_intimacy	intimacy	亲密行为
涉黄审核	sexual_vulgar	vulgar	低俗行为
涉黄审核	sexual_special	pregnant	孕肚裸露
暴恐审核	terrorist_group	terrorist_group	恐怖组织
暴恐审核	terrorist	terrorist	暴恐人物
暴恐审核	terror_event	blood,corpse,murder,explosion,riot,weapon,police,traffic	血腥,尸体,绑架及杀人,爆炸火灾,暴乱,军事武器,警察部队,车祸
涉政审核	politician	politician_positive, politician_negative,bad_artist	涉政正面人物,涉政负面人物,劣迹艺人
涉政审核	political_event	political_event_positive,political_event_negative	涉政正面事件,涉政负面事件
涉政审核	political_group	political_group_positive,political_group_negative	涉政正面组织,涉政负面组织
广告审核	ad_brand	brand	品牌标识
广告审核	ad_marketing	qrcode,contact,website,commercial	二维码,联系方式,网址,软文推广
违禁审核	bad_behavior	smoke,drink,bad_behavior_gamble,drug	吸烟,喝酒,赌博,毒品
违禁审核	illegal_gamble	gamble	赌博
违禁审核	illegal_forgery	forgery	假冒伪劣及造假盗窃
违禁审核	illegal_trade	trade	非法交易
违禁审核	illegal_privacy	privacy	非法获取私人信息
质量审核	disgust	disgust_image	恶心图
官方文本黑库	official_text_black_lib	baidu_illegal_textlib	违禁词库
官方图片黑库	image_black_lib	default_image_black_lib,meg_image_lib	百度云风控,互联网安全管控

审核证据

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

参数	类型	描述
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": "天安门是语音识别的涉政文字"
            }
        }]
    }]
}

文本审核接口

通知接口

百度智能云

媒体内容审核 VCR

媒体内容审核 VCR

直播审核接口

提交直播审核

查询直播流审核状态

直播流审核列表页

取消直播流审核

直播流审核结果回调格式

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

直播流结束回调

审核结果说明

审核结果

审核标记

审核维度/审核物料

审核类型

审核结果项

审核项

审核证据

审核结果示例