全部产品
Search

搜索本产品

    媒体处理：SubmitMediaCensorJob - 提交媒体审核作业

    文档中心

    媒体处理：SubmitMediaCensorJob - 提交媒体审核作业

    更新时间：Dec 26, 2024

    提交媒体审核作业。

    接口说明

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

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

    QPS 限制

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

    调试

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

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用背景高亮的方式表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    mts:SubmitMediaCensorJobnone
    *全部资源
    *
      无
    		无

    请求参数

    名称类型必填描述示例值
    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****"
}

    错误码

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

    变更历史

    变更时间变更内容概要操作
    暂无变更历史