首页 媒体处理 API参考指南 API目录 媒体审核接口 QueryMediaCensorJobList - 查询媒体审核作业列表

QueryMediaCensorJobList - 查询媒体审核作业列表

查询媒体审核作业列表。

接口说明

本接口只支持查询三个月内的媒体审核作业列表。

QPS限制

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

调试

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

调试

授权信息

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

请求参数

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

媒体审核作业ID。可以从提交媒体审核作业的返回参数中获取,多个使用半角逗号(,)分隔。

fa9c34be3bcf42919ac4d1775239****,78dc866518b843259669df58ed30****
NextPageTokenstring

下一页标识,第一次提交时为空即可。下一页标识将在第一次查询后返回。

79aff3eee82242e092899db5f669****
MaximumPageSizelong

每页最大返回数。

  • 默认:30
  • 取值:1~300
20
Statestring

需要查询的作业状态。取值:

  • All:全部。

  • Queuing:排队中。

  • Analysing:分析中。

  • Fail:失败。

  • Success:成功。

All
StartOfJobCreatedTimeRangestring

最早任务创建时间。

  • 日期格式按照ISO8601标准表示,并需要使用UTC时间。
  • 格式为:YYYY-MM-DDThh:mm:ssZ 。
2021-12-22T03:48:05Z
EndOfJobCreatedTimeRangestring

最晚任务创建时间。

  • 日期格式按照ISO8601标准表示,并需要使用UTC时间。
  • 格式为:YYYY-MM-DDThh:mm:ssZ 。
2022-02-14T02:16:07Z
PipelineIdstring

管道ID。可以通过媒体处理控制台 > 全局设置 > 管道获取。

c5b30b7c0d0e4a0abde1d5f9e751****

返回参数

名称类型描述示例值
object

返回参数。

MediaCensorJobListarray

媒体审核作业列表。

object

媒体审核作业详细信息。

CreationTimestring

任务创建时间。

2021-11-04T07:25:48Z
FinishTimestring

完成时间。

2021-11-04T07:25:48Z
Suggestionstring

处理建议。可取值:

  • pass:通过。
  • review:人工重审。
  • block:拦截。
pass
CoverImageCensorResultsarray

封面图片审查结果列表。

object

封面图片审查结果详细信息。

Objectstring

封面图片的OSS Object。

test/ai/censor/v2/vme-****.jpg
Locationstring

封面图片的OSS Location。

oss-cn-shanghai
Bucketstring

封面图片的OSS Bucket。

example-Bucket-****
Resultsarray

作业审核结果。

object

作业审核结果详细信息。

Suggestionstring

作业整体审核结果。取值:

  • pass:通过。
  • review:人工重审。
  • block:拦截。
说明任何一种类型的审核结果是Review时,整体结果为Review,任何一种类型的审核结果是Block时,整体结果为Block。
pass
Labelstring

审核结果的标签,多个使用半角逗号(,)分隔。

  • 图片智能鉴黄(porn)审核结果分类:

    • nomal:正常。
    • sexy:性感。
    • porn:色情。
  • 图片暴恐涉政(terrorism)结果分类:

    • naomal:正常。
    • bloody:血腥。
    • explosion:爆炸烟光。
    • outfit:特殊装束。
    • logo:特殊标识。
    • weapon:武器。
    • politics:涉政。
    • violence:打斗。
    • crowd:聚众。
    • parade:游行。
    • carcrash:车祸现场。
    • flag:旗帜。
    • location:地标。
    • others:其他。
  • 图文违规(ad)结果分类:

    • normal:正常。
    • ad:其他广告。
    • politics:文字含涉政内容。
    • porn:文字含涉黄内容。
    • abuse:文字含辱骂内容。
    • terrorism:文字含暴恐内容。
    • contraband:文字含违禁内容。
    • spam:文字含其他垃圾内容。
    • npx:牛皮藓广告。
    • qrcode:含二维码。
    • programCode:含小程序码。
  • 图片不良场景(live)结果分类:

    • normal:正常。
    • meaningless:图片中无内容(例如黑屏、白屏)。
    • PIP:画中画。
    • smoking:吸烟。
    • drivelive:车内直播。
  • 图片Logo(Logo)结果分类:

    • normal:正常。
    • TV:含受管控的Logo。
    • trademark:含商标。
normal
Scenestring

审核场景。

  • porn:鉴黄。
  • terrorism:暴恐涉政。
  • ad:图文违规。
  • live:不良场景。
  • Logo:图片Logo。
live
Ratestring

分值。可取值:0~100。

100
Statestring

作业状态。

Success
TitleCensorResultobject

标题审核结果。

Suggestionstring

处理建议。取值:

  • pass:通过。

  • review:人工重审。

  • block:拦截。

block
Labelstring

审核结果的标签,多个使用半角逗号(,)分隔。

  • normal:普通

  • spam:含垃圾信息

  • ad:广告

  • abuse:辱骂

  • flood:灌水

  • contraband:违禁

  • meaningless:无意义

meaningless
Scenestring

审核场景。取固定值:antispam,文本反垃圾。

antispam
Ratestring

分值。

99.91
Messagestring

作业失败时错误信息。执行成功时不返回此参数。

The resource operated cannot be found
Inputobject

作业输入。

Objectstring

输入文件的OSS Object。

test/ai/censor/test-****.mp4
Locationstring

输入文件的OSS Location。

oss-cn-shanghai
Bucketstring

输入文件的OSS Bucket。

bucket-test-in-****
BarrageCensorResultobject

弹幕审核结果。

Suggestionstring

处理建议。可取值:

  • pass:通过。

  • review:人工重审。

  • block:拦截。

pass
Labelstring

审核结果分类,多个使用半角逗号(,)分隔。取值:

  • spam:含垃圾信息。
  • ad:广告。
  • abuse:辱骂。
  • flood:灌水。
  • contraband:违禁。
  • meaningless:无意义。
  • normal:普通。
normal
Scenestring

审核场景。固定取值:antispam,文本反垃圾。

antispam
Ratestring

分值。

99.91
DescCensorResultobject

描述审核结果。

Suggestionstring

处理建议。可取值:

  • pass:通过。

  • review:人工重审。

  • block:拦截。

pass
Labelstring

审核结果分类,多个使用半角逗号(,)分隔。取值:

  • spam:含垃圾信息。
  • ad:广告。
  • abuse:辱骂。
  • flood:灌水。
  • contraband:违禁。
  • meaningless:无意义。
  • normal:普通。
ad
Scenestring

审核场景。固定取值:antispam,文本反垃圾。

antispam
Ratestring

分值。

100
VideoCensorConfigobject

视频审查配置。

OutputFileobject

视频截图结果的保存地址。

Objectstring

截图输出文件 (OSS Object)。

说明示例中{Count}是占位符,图片Object依次为output00001-****.jpg,output00002-****.jpg等。
output{Count}.jpg
Locationstring

截图输出OSS Bucket所在的OSS Location。

oss-cn-shanghai
Bucketstring

截图输出文件所在OSS Bucket。

test-bucket-****
VideoCensorstring

是否需要审核视频内容。默认值:true。可取值:

  • true:审核。

  • false:不审核。

true
BizTypestring

审核模板。默认common(默认模板)。

说明不填默认为common,如果是通过提交工单自定义的审核模板,此项返回UID。
common
JobIdstring

媒体审核作业ID。

f8f166eea7a44e9bb0a4aecf9543****
UserDatastring

用户自定义数据。

example userdata ****
Codestring

作业失败时错误码。执行成功时此参数不返回。

InvalidParameter.ResourceNotFound
VensorCensorResultobject

视频审查结果。

VideoTimelinesarray

详细时间点的审核结果,按照时间从小到大排序。

object

详细信息。

Timestampstring

视频中的位置。格式:hh:mm:ss[.SSS]

00:02:59.999
Objectstring

截图输出文件(OSS Object)。

说明示例中{Count}是占位符,图片Object依次为output00001-****.jpg,output00002-****.jpg等。
output{Count}.jpg
CensorResultsarray

包含多种类型审核结果的标签、分值等。

object

详细信息。

Suggestionstring

处理建议。取值:

  • pass:通过,

  • review:人工重审,

  • block:拦截。

block
Labelstring

审核结果分类,多个使用半角逗号(,)分隔。取值:

  • 图片鉴黄(porn)审核结果分类:

    • porn:色情。
    • sexy:性感。
    • normal:通过。
  • 暴恐涉政(terrorism)审核结果分类:

    • normal:正常。
    • bloody:血腥。
    • explosion:爆炸烟光。
    • outfit:特殊装束。
    • logo:特殊标识。
    • weapon:武器。
    • politics:涉政。
    • violence:打斗。
    • crowd:聚众。
    • parade:游行。
    • carcrash:车祸现场。
    • flag:旗帜。
    • location:地标。
    • others:其他。
  • 广告(ad)审核结果分类:

    • normal:正常。
    • ad:其他广告。
    • politics:文字含涉政内容。
    • porn:文字含涉黄内容。
    • abuse:文字含辱骂内容。
    • terrorism:文字含暴恐内容。
    • contraband:文字含违禁内容。
    • spam:文字含其他垃圾内容。
    • npx:牛皮藓广告。
    • qrcode:含二维码。
    • programCode:含小程序码。
  • 不良场景(live)结果分类:

    • normal:正常。
    • meaningless:图片中无内容(例如黑屏、白屏)。
    • PIP:画中画。
    • smoking:吸烟。
    • drivelive:车内直播。
  • Logo(logo)审核结果分类:

    • normal:正常。
    • TV:含受管控的Logo。
    • trademark:含商标。
normal
Scenestring

审核场景。

  • porn:鉴黄。
  • terrorism:暴恐涉政。
  • ad:图文违规。
  • live:不良场景。
  • logo:图片Logo。
pron
Ratestring

分值。

99.99
NextPageTokenstring

下一页标识。

ea04afcca7cd4e80b9ece8fbb251****
CensorResultsarray

审核结果集合,包含各种场景(黄、暴、恐、政)的概要信息。

object

审核结果详细信息。

Suggestionstring

处理建议。取值:

  • pass:通过。

  • review:人工重审。

  • block:拦截。

review
Labelstring

审核结果分类,多个使用半角逗号(,)分隔。取值:

  • 图片鉴黄(porn)审核结果分类:

    • porn:色情。
    • sexy:性感。
    • normal:通过。
  • 暴恐涉政(terrorism)审核结果分类:

    • normal:正常。
    • bloody:血腥。
    • explosion:爆炸烟光。
    • outfit:特殊装束。
    • logo:特殊标识。
    • weapon:武器。
    • politics:涉政。
    • violence:打斗。
    • crowd:聚众。
    • parade:游行。
    • carcrash:车祸现场。
    • flag:旗帜。
    • location:地标。
    • others:其他。
  • 广告(ad)审核结果分类:

    • normal:正常。
    • ad:其他广告。
    • politics:文字含涉政内容。
    • porn:文字含涉黄内容。
    • abuse:文字含辱骂内容。
    • terrorism:文字含暴恐内容。
    • contraband:文字含违禁内容。
    • spam:文字含其他垃圾内容。
    • npx:牛皮藓广告。
    • qrcode:含二维码。
    • programCode:含小程序码。
  • 不良场景(live)结果分类:

    • normal:正常。
    • meaningless:图片中无内容(例如黑屏、白屏)。
    • PIP:画中画。
    • smoking:吸烟。
    • drivelive:车内直播。
  • Logo(logo)审核结果分类:

    • normal:正常。
    • TV:含受管控的Logo。
    • trademark:含商标。
meaningless
Scenestring

审核场景。

  • porn:鉴黄。
  • terrorism:暴恐涉政。
  • ad:图文违规。
  • live:不良场景。
  • logo:图片Logo。
terrorism
Ratestring

分值。

100
PipelineIdstring

管道ID。

c5b30b7c0d0e4a0abde1d5f9e751****
RequestIdstring

请求ID。

D1D5C080-8E2F-5030-8AB4-13092F17631B
NextPageTokenstring

下一页标识,32位UUID。查询结果大于一页时返回,每次查询值都会更新。

9b1a42bc6e8d46e6a1383b7e7f01****
NonExistIdsarray

不存在的作业ID列表。如果为空则不返回此参数。

string

作业ID。

78dc866518b843259669df58ed30****

示例

正常返回示例

JSON格式

{
  "MediaCensorJobList": {
    "MediaCensorJob": [
      {
        "CreationTime": "2021-11-04T07:25:48Z",
        "FinishTime": "2021-11-04T07:25:48Z",
        "Suggestion": "pass",
        "CoverImageCensorResults": {
          "CoverImageCensorResult": [
            {
              "Object": "test/ai/censor/v2/vme-****.jpg",
              "Location": "oss-cn-shanghai",
              "Bucket": "example-Bucket-****",
              "Results": {
                "Result": [
                  {
                    "Suggestion": "pass",
                    "Label": "normal",
                    "Scene": "live",
                    "Rate": "100"
                  }
                ]
              }
            }
          ]
        },
        "State": "Success",
        "TitleCensorResult": {
          "Suggestion": "block",
          "Label": "meaningless",
          "Scene": "antispam",
          "Rate": "99.91"
        },
        "Message": "The resource operated cannot be found",
        "Input": {
          "Object": "test/ai/censor/test-****.mp4",
          "Location": "oss-cn-shanghai",
          "Bucket": "bucket-test-in-****"
        },
        "BarrageCensorResult": {
          "Suggestion": "pass",
          "Label": "normal",
          "Scene": "antispam",
          "Rate": "99.91"
        },
        "DescCensorResult": {
          "Suggestion": "pass",
          "Label": "ad",
          "Scene": "antispam",
          "Rate": "100"
        },
        "VideoCensorConfig": {
          "OutputFile": {
            "Object": "output{Count}.jpg",
            "Location": "oss-cn-shanghai",
            "Bucket": "test-bucket-****"
          },
          "VideoCensor": "true",
          "BizType": "common"
        },
        "JobId": "f8f166eea7a44e9bb0a4aecf9543****",
        "UserData": "example userdata ****",
        "Code": "InvalidParameter.ResourceNotFound",
        "VensorCensorResult": {
          "VideoTimelines": {
            "VideoTimeline": [
              {
                "Timestamp": "00:02:59.999",
                "Object": "output{Count}.jpg",
                "CensorResults": {
                  "CensorResult": [
                    {
                      "Suggestion": "block",
                      "Label": "normal",
                      "Scene": "pron",
                      "Rate": "99.99"
                    }
                  ]
                }
              }
            ]
          },
          "NextPageToken": "ea04afcca7cd4e80b9ece8fbb251****",
          "CensorResults": {
            "CensorResult": [
              {
                "Suggestion": "review",
                "Label": "meaningless",
                "Scene": "terrorism",
                "Rate": "100"
              }
            ]
          }
        },
        "PipelineId": "c5b30b7c0d0e4a0abde1d5f9e751****"
      }
    ]
  },
  "RequestId": "D1D5C080-8E2F-5030-8AB4-13092F17631B",
  "NextPageToken": "9b1a42bc6e8d46e6a1383b7e7f01****",
  "NonExistIds": {
    "String": [
      "78dc866518b843259669df58ed30****"
    ]
  }
}

错误码

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

阿里云首页 媒体处理 相关技术圈