调用SubmitMediaCensorJob提交媒体审核作业。

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

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 否 SubmitMediaCensorJob

操作接口名，系统规定参数，取值：SubmitMediaCensorJob。

PipelineId String 是 b22c173cced04565b1f38f1ecc39e14e

管道ID，用于绑定消息通知。可填空字符串（""），表示使用默认的管道执行任务。默认管道并发为10，需要提升并发数请提交工单。

说明 管道目前仅支持后台创建，相关查询、更新接口请参见更新管道
VideoCensorConfig String 是 {"Scenes" : ["porn"], "OutputFile":{"Bucket": "example-001","Location": "oss-cn-hangzhou","Object": "test/example-{Count}.jpg"}}

视频审核配置和输出截图的oss地址。

Json对象。

OutputFile:

  • Bucket：输出文件oss bucket名字
  • Location: Oss区域，必须和服务所在区域一致
  • Object: 待检测oss object, 其中{Count}为截帧图片序号替换符
  • Scene: 检测场景

Scenes可以选择检测场景，不填默认检测暴恐和涉黄

可选场景

  • porn 涉黄
  • terrorism 暴恐
  • ad 图文违规
  • live 不良场景
  • logo logo图标
  • audio 语音反垃圾
    说明 对于有音频轨道的输入文件，audio场景会进行音频审核，没有音轨的输入文件不要填写audio。
Input String 否 {"Bucket":"example-bucket","Location":"oss-cn-shanghai","Object":"example.flv"}

待审核的媒体文件OSS地址，支持视频文件、音频文件。如需要审核图片文件请使用CoverImage参数传入。

Json对象，请参考附录中Input详情参数。

  • Bucket：输入文件oss bucket名字
  • Location: Oss区域，必须和服务所在区域一致
  • Object: 待检测oss object
CoverImages String 否 [{"Bucket":"example-bucket","Location":"oss-cn-shanghai","Object":"example.jpeg"}]

封面图片的OSS文件，最多支持5个封面图片，Json数组。

  • Bucket：输入文件oss bucket名字
  • Location: Oss区域，必须和服务所在区域一致
  • Object: 待检测oss object
Title String 否 Hello World

视频标题，最大长度64个字节。
Description String 否 API overview

视频介绍，最大长度128个字节。
UserData String 否 UserDatatestid-001

用户自定义数据，最大长度128个字节。

返回数据

名称 类型 示例值 描述
JobId String 88c6ca184c0e47098a5b665e2a126797

视频审核作业ID
RequestId String 25818875-5F78-4A13-BEF6-D7393642CA58

请求ID

异步通知消息参数

参数

类型

描述

Type

String

消息类型：MediaCensor

MediaCensorJobNotify

AliyunMediaCensorJobNotify

媒体审核作业通知

UserData

String

用户自定义数据

示例

请求示例

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=SubmitMediaCensorJob
&PipelineId=b22c173cced04565b1f38f1ecc39e14e
&VideoCensorConfig={“CensorVideo”:”true”,“BizType”:”common”,“OutputFile”:{“Bucket”: “example-001”,“Location”: “oss-cn-hangzhou”,“Object”: “test/example-{Count}.jpg”}}
&<公共请求参数>

正常返回示例

XML 格式 

<SubmitMediaCensorJobResponse>
      <RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
      <JobId>88c6ca184c0e47098a5b665e2a126797</JobId>
</SubmitMediaCensorJobResponse>

JSON 格式 

{
    "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
    "JobId": "88c6ca184c0e47098a5b665e2a126797"
}

错误码

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