直播审核接口

提交直播流审核

用户提供直播流地址,创建一次直播审核。

  • 正在审核中的直播(以直播流地址区分)无法重复发起审核

请求语法

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

请求参数

请求体

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

请求示例

PUT /v1/stream HTTP/1.1
host: vcr.bj.baidubce.com
authorization: <bce-authorization-string>
content-type: application/json

{
    "source": "rtmp://domain/app/stream",
    "notifcation": "vcr_callback"
}

响应体

响应示例

HTTP/1.1 200 OK

查询直播流审核结果

查询一段时间内某条直播流的审核结果。

请求语法

GET /v<version>/stream HTTP/1.1
host: vcr.bj.baidubce.com
authorization: <bce-authorization-string>
content-type: application/json

请求参数

参数 类型 描述 是否必须
source String 直播流地址
startTime String 查询起始时间,UTC时间 否,默认为endTime之前1小时
endTime String 查询结束时间,UTC时间 否,默认当前时间

说明:

以上3个参数均需要经过urlEncode。

请求体

请求示例

GET /v1/stream?source=rtmp%3a%2f%2fdomain%2fapp%2fstream&startTime=2017-08-01T00%3a00%3a00Z&endTime=2017-08-01T01%3a00%3a00Z HTTP/1.1
host: vcr.bj.baidubce.com
authorization: <bce-authorization-string>
content-type: application/json

响应体

响应参数

参数 类型 描述
source String 直播流地址
status String 直播流当前状态,可选值:PROCESSING/FINISHED/ERROR
notification String 通知名称
type String 直播流类型, 可选值:video,audio
error Object 该流最近一次错误信息,仅status=ERROR时存在
+ code String 错误码
+ message String 错误消息
createTime Date 该流最近一次直播审核开始时间
finishTime Date 该流最近一次直播审核完成时间,仅status=FINISHED/ERROR时存在
label String 直播流在查询时间段内的审核结果标记
results Array 查询时间段内的审核结果
+ type String 审核类型
+ items Array 审核结果项数组
++ subType String 审核项
++ target String 审核物料类型,可选值:thumbnail,speech,character
++ liveTime Date 物料时间,UTC;仅target=thumbnail/character时存在
++ startTime Date 物料的起始时间,UTC;仅target=speech时存在
++ endTime Date 物料的结束时间,UTC;和startTime同时存在
++ 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 文本证据

响应示例

HTTP/1.1 200 OK
{
    "source": "rtmp://domain/app/stream",
    "type": "video",
    "status": "FINISHED",
    "createTime": "2017-08-01T12:00:00Z",
    "finishTime": "2017-08-01T13:06:48",
    "label": "REVIEW",
    "results": [{
        "type": "sexual_porn",
        "items": [{
            "subType": "behavior",
            "target": "thumbnail",
            "liveTime": "2017-08-01T12:43:00Z",
            "confidence": 68,
            "label": "REVIEW",
            "evidence": {
                    "thumbnail": "http://xx/xx.jpg"
            }
        }]
    }]
}