文档

SubmitMediaCensorJob - 提交媒体审核作业

更新时间:

提交媒体审核作业。

接口说明

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

  • 媒体审核功能,目前开通的地域为华北 2(北京)、华东 2(上海)、亚太东南 1(新加坡),其他地域暂不支持。

QPS 限制

本接口的单用户 QPS 限制为 100 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见 QPS 限制

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
Inputstring

待审核的媒体文件 OSS 地址,支持视频文件、音频文件。可以通过 MPS 控制台 > 媒体管理 > 媒体列表获取。如需要审核图片文件请使用CoverImage参数传入。JSON 对象,更多信息请参考参数详情中 Input 详情参数。

  • Bucket:输入文件 OSS Bucket 名称。

  • Location:OSS 区域,必须和 MPS 服务所在区域一致。

  • Object:待检测 OSS Object。

    说明 Object 不能以斜杠(/)开头,否则会导致接口调用失败。
{"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"}
CoverImagesstring

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

  • Bucket:输入文件 OSS Bucket 名称。

  • Location:OSS 区域,必须和 MPS 服务所在区域一致。

  • Object:待检测 OSS Object。

    说明 Object 不能以斜杠(/)开头,否则会导致接口调用失败。
[{"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.jpeg"}]
Titlestring

视频标题,最大长度 64 个字节。

Hello World
Descriptionstring

视频介绍,最大长度 128 个字节。

example description
Barragesstring

字符串。

hello world
PipelineIdstring

管道 ID,用于绑定消息通知。可以通过 MPS 控制台 > 全局设置 > 管道获取。可填空字符串(""),表示使用默认的管道执行任务。默认管道并发为 10,需要提升并发数请提交工单

说明 管道目前仅支持后台创建,相关查询、更新接口请参见更新管道
b22c173cced04565b1f38f1ecc39****
VideoCensorConfigstring

视频审核配置和输出截图的 OSS 地址。可以通过 MPS 控制台 > 媒体管理 > 媒体列表获取。

JSON 对象。

  • OutputFile:

    • Bucket:输出文件 OSS Bucket 名字。
    • Location:OSS 区域,必须和 MPS 服务所在区域一致。
    • Object: 待检测 OSS Object,其中{Count}为截帧图片序号替换符。

    其中,审核结果详细信息保存在 OutputFile 相同的文件夹下,命名为{jobId}.output,output 文件具体字段格式,请参见媒体审核结果文件字段

  • 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。
{"Scenes" : ["porn"], "OutputFile":{"Bucket": "example-001","Location": "oss-cn-hangzhou","Object": "test/example-{Count}.jpg"},"SaveType" : "abnormal","BizType":"common"}
UserDatastring

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

UserDatatestid-001-****
ExternalUrlstring

视频的 URL 链接。

http://www.example.com/video-****/test-****.mp4

返回参数

名称类型描述示例值
object

返回参数。

RequestIdstring

请求 ID。

25818875-5F78-4A13-BEF6-D7393642CA58
JobIdstring

视频审核作业 ID。建议您保存此 ID 便于后续调用其他接口时使用。

88c6ca184c0e47098a5b665e2****

异步通知消息参数

参数类型描述
TypeString消息类型:MediaCensor
MediaCensorJobNotifyAliyunMediaCensorJobNotify媒体审核作业通知
UserDataString用户自定义数据

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

变更时间变更内容概要操作
暂无变更历史
  • 本页导读 (1)
文档反馈