调用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控制台 > 媒体管理 > 媒体列表获取。如需要审核图片文件请使用CoverImage参数传入。JSON对象，更多信息请参考参数详情中Input详情参数。

  • Bucket：输入文件OSS Bucket名称。
  • Location：OSS区域，必须和MPS服务所在区域一致。
  • Object：待检测OSS Object。
    说明 Object不能以斜杠（/）开头，否则会导致接口调用失败。
CoverImages String 否 [{"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.jpeg"}]

封面图片的OSS文件，可以通过MPS控制台 > 媒体管理 > 媒体列表获取。最多支持5个封面图片，JSON数组。

  • Bucket：输入文件OSS Bucket名称。
  • Location：OSS区域，必须和MPS服务所在区域一致。
  • Object：待检测OSS Object。
    说明 Object不能以斜杠（/）开头，否则会导致接口调用失败。
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对象。

  • OutputFile：
    • Bucket：输出文件OSS Bucket名字。
    • Location：OSS区域，必须和MPS服务所在区域一致。
    • Object: 待检测OSS Object，其中{Count}为截帧图片序号替换符。
  • StoreVideoTimeline: 审核是否要输出{jobId}.video_timeline文件，存储在OSS中。true：表示要输出，false表示不输出，不填默认不输出。文件格式，请参见，查询媒体作业（videoTimeline示例）。
  • SaveType：输出模式。abnormal表示只输出有问题的截帧，all表示输出所有截帧。
  • Biztype：表示审核模版。common为默认模版，不填默认为common，如果需要自定义审核模版需要提工单，然后将用户的uid填入此项。
  • Scene：检测场景。Scenes可以选择检测场景，不填默认检测暴恐和涉黄。可选场景：
    • porn：涉黄
    • terrorism：暴恐
    • ad：图文违规
    • live：不良场景
    • logo：图标
    • audio：语音反垃圾
      说明 对于有音频轨道的输入文件，audio场景会进行音频审核，没有音轨的输入文件不要填写audio。
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****"
}

错误码

访问错误中心查看更多错误码。