提交媒体审核作业接口,作业是异步执行方式,作业添加到管道中调度排队和执行。可以调用“查询媒体审核作业”接口查询作业执行结果,也可以使用异步的消息通知机制。

请求参数

名称 类型 必填项 描述
Action String 操作接口名,系统规定参数,取值:SubmitMediaCensorJob
Input String 媒体输入文件OSS地址。Json对象。

例如:{“Bucket”:”example-bucket”,“Location”:”oss-cn-shanghai”,“Object”:”example.flv”}

PipelineId String 管道ID,用于绑定消息通知。
VideoCensorConfig String 视频审核配置和输出截图的oss地址。Json对象,VideoCensorConfig定义详见参数详情的’VideoCensorConfig’部分。

例如:{“CensorVideo”:”true”,“BizType”:”common”,“OutputFile”:{“Bucket”: “example-001”,“Location”: “oss-cn-hangzhou”,“Object”: “test/example-{Count}.jpg”}}

CoverImages String 封面图片的OSS文件,最多支持5个封面图片。

Json数组,例如:[{“Bucket”:”example-bucket”,“Location”:”oss-cn-shanghai”,“Object”:”example.jpeg”}]

Title String 视频标题,最大长度64个字节。
Description String 视频介绍,最大长度128个字节。
Barrages String 视频弹幕,最大长度8192个字节。
UserData String 用户自定义数据,最大长度128个字节。

返回参数

名称 类型 描述
JobId String 视频审核作业id
异步通知消息参数
名称 类型 描述
Type String 消息类型:MediaCensor
MediaCensorJobNotify AliyunMediaCensorJobNotify 媒体审核作业通知
UserData String 用户自定义数据

示例

请求示例
http://mts.cn-hangzhou.aliyuncs.com/?Signature=oXVxcd3uMuTpkD%2BfzcJFHOdT1tU%3D&SignatureVersion=1.0&Action=SubmitMediaCensorJob&Input=%7B%22Bucket%22%3A%22example-bucket%22%2C%22Location%22%3A%22oss-cn-shanghai%22%2C%22Object%22%3A%22example.flv%22%7D&Format=XML&SignatureNonce=fbda715e-1d22-4cc2-9bf2-62b518fb6194&Version=2014-06-18&AccessKeyId=BlctR6mMqO6mhSxD&PipelineId=b22c173cced04565b1f38f1ecc39e14e&SignatureMethod=HMAC-SHA1&VideoCensorConfig=%7B%22OutputFile%22%3A%7B%22Bucket%22%3A%20%22example-001%22%2C%22Location%22%3A%20%22oss-cn-hangzhou%22%2C%22Object%22%3A%20%22test%2Fexample-%7BCount%7D.jpg%22%7D%7D&Timestamp=2018-08-08T06%3A13%3A05Z<公共参数>

返回示例

XML格式
<SubmitMediaCensorJobResponse>
    <RequestId>
        25818875-5F78-4A13-BEF6-D7393642CA58
    </RequestId>
    <JobId>88c6ca184c0e47098a5b665e2a126797</JobId>
</SubmitCensorJobResponse>
JSON格式
{
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "JobId": "88c6ca184c0e47098a5b665e2a126797"
}