调用SubmitMediaCensorJob提交媒体审核作业。
使用说明
本接口提交的作业是异步执行方式,作业添加到管道中调度排队和执行。可以调用查询媒体审核作业接口查询作业执行结果,也可以使用异步的消息通知机制。
QPS限制
本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SubmitMediaCensorJob |
操作接口名,系统规定参数,取值:SubmitMediaCensorJob。 |
Input | String | 否 | {"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"} |
待审核的媒体文件OSS地址,支持视频文件、音频文件。可以通过MPS控制台 > 媒体管理 > 媒体列表获取。如需要审核图片文件请使用
|
CoverImages | String | 否 | [{"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.jpeg"}] |
封面图片的OSS文件,可以通过MPS控制台 > 媒体管理 > 媒体列表获取。最多支持5个封面图片,JSON数组。
|
Title | String | 否 | Hello World |
视频标题,最大长度64个字节。 |
Description | String | 否 | example description |
视频介绍,最大长度128个字节。 |
Barrages | String | 否 | hello world |
字符串。 |
PipelineId | String | 是 | b22c173cced04565b1f38f1ecc39**** |
管道ID,用于绑定消息通知。可以通过MPS控制台 > 全局设置 > 管道获取。可填空字符串(""),表示使用默认的管道执行任务。默认管道并发为10,需要提升并发数请提交工单。 说明 管道目前仅支持后台创建,相关查询、更新接口请参见更新管道。
|
VideoCensorConfig | String | 是 | {"Scenes" : ["porn"], "OutputFile":{"Bucket": "example-001","Location": "oss-cn-hangzhou","Object": "test/example-{Count}.jpg"},"SaveType" : "abnormal","BizType":"common"} |
视频审核配置和输出截图的OSS地址。可以通过MPS控制台 > 媒体管理 > 媒体列表获取。 JSON对象。
|
UserData | String | 否 | UserDatatestid-001-**** |
用户自定义数据,最大长度128个字节。 |
ExternalUrl | String | 否 | http://www.example.com/video-****/test-****.mp4 |
视频的URL链接。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 25818875-5F78-4A13-BEF6-D7393642CA58 |
请求ID。 |
JobId | String | 88c6ca184c0e47098a5b665e2**** |
视频审核作业ID。建议您保存此ID便于后续调用其他接口时使用。 |
异步通知消息参数
参数 |
类型 |
描述 |
---|---|---|
Type |
String |
消息类型:MediaCensor |
MediaCensorJobNotify |
AliyunMediaCensorJobNotify |
媒体审核作业通知 |
UserData |
String |
用户自定义数据 |
示例
请求示例
http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=SubmitMediaCensorJob
&Input={"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"}
&CoverImages=[{"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.jpeg"}]
&Title=Hello World
&Description=example description
&Barrages=hello world
&PipelineId=b22c173cced04565b1f38f1ecc39****
&VideoCensorConfig={"Scenes" : ["porn"], "OutputFile":{"Bucket": "example-001","Location": "oss-cn-hangzhou","Object": "test/example-{Count}.jpg"},"SaveType" : "abnormal","BizType":"common"}
&UserData=UserDatatestid-001-****
&ExternalUrl=http://www.example.com/video-****/test-****.mp4
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<SubmitMediaCensorJobResponse>
<RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
<JobId>88c6ca184c0e47098a5b665e2****</JobId>
</SubmitMediaCensorJobResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "25818875-5F78-4A13-BEF6-D7393642CA58",
"JobId" : "88c6ca184c0e47098a5b665e2****"
}
错误码
访问错误中心查看更多错误码。