调用QueryMediaCensorJobList查询媒体审核作业列表。

使用说明

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

QPS限制

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

调试

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

请求参数

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

系统规定参数。取值:QueryMediaCensorJobList

JobIds String fa9c34be3bcf42919ac4d1775239****,78dc866518b843259669df58ed30****

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

NextPageToken String 79aff3eee82242e092899db5f669****

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

MaximumPageSize Long 20

每页最大返回数。

  • 默认:30
  • 取值:1~300
State String All

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

  • All:全部。
  • Queuing:排队中。
  • Analysing:分析中。
  • Fail:失败。
  • Success:成功。
StartOfJobCreatedTimeRange String 2021-12-22T03:48:05Z

最早任务创建时间。

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

最晚任务创建时间。

  • 日期格式按照ISO8601标准表示,并需要使用UTC时间。
  • 格式为:YYYY-MM-DDThh:mm:ssZ 。
PipelineId String c5b30b7c0d0e4a0abde1d5f9e751****

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

返回数据

名称 类型 示例值 描述
MediaCensorJobList Array of MediaCensorJob

媒体审核作业列表。

MediaCensorJob
CreationTime String 2021-11-04T07:25:48Z

任务创建时间。

FinishTime String 2021-11-04T07:25:48Z

完成时间。

Suggestion String pass

处理建议。可取值:

  • pass:通过。
  • review:人工重审。
  • block:拦截。
CoverImageCensorResults Array of CoverImageCensorResult

封面图片审查结果列表。

CoverImageCensorResult
Object String test/ai/censor/v2/vme-****.jpg

封面图片的OSS Object。

Location String oss-cn-shanghai

封面图片的OSS Location。

Bucket String example-Bucket-****

封面图片的OSS Bucket。

Results Array of Result

作业审核结果。

Result
Suggestion String pass

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

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

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

  • 图片智能鉴黄(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:含商标。
Scene String live

审核场景。

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

分值。可取值:0~100。

State String Success

作业状态。

TitleCensorResult Object

标题审核结果。

Suggestion String block

处理建议。取值:

  • pass:通过。
  • review:人工重审。
  • block:拦截。
Label String meaningless

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

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

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

Rate String 99.91

分值。

Message String The resource operated cannot be found

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

Input Object

作业输入。

Object String test/ai/censor/test-****.mp4

输入文件的OSS Object。

Location String oss-cn-shanghai

输入文件的OSS Location。

Bucket String bucket-test-in-****

输入文件的OSS Bucket。

BarrageCensorResult Object

弹幕审核结果。

Suggestion String pass

处理建议。可取值:

  • pass:通过。
  • review:人工重审。
  • block:拦截。
Label String normal

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

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

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

Rate String 99.91

分值。

DescCensorResult Object

描述审核结果。

Suggestion String pass

处理建议。可取值:

  • pass:通过。
  • review:人工重审。
  • block:拦截。
Label String ad

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

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

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

Rate String 100

分值。

VideoCensorConfig Object

视频审查配置。

OutputFile Object

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

Object String output{Count}.jpg

截图输出文件 (OSS Object)。

说明 示例中{Count}是占位符,图片Object依次为output00001-****.jpg,output00002-****.jpg等。
Location String oss-cn-shanghai

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

Bucket String test-bucket-****

截图输出文件所在OSS Bucket。

VideoCensor String true

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

  • true:审核。
  • false:不审核。
BizType String common

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

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

媒体审核作业ID。

UserData String example userdata ****

用户自定义数据。

Code String InvalidParameter.ResourceNotFound

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

VensorCensorResult Object

视频审查结果。

VideoTimelines Array of VideoTimeline

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

VideoTimeline
Timestamp String 00:02:59.999

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

Object String output{Count}.jpg

截图输出文件(OSS Object)。

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

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

CensorResult
Suggestion String block

处理建议。取值:

  • pass:通过,
  • review:人工重审,
  • block:拦截。
Label String normal

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

  • 图片鉴黄(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:含商标。
Scene String pron

审核场景。

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

分值。

NextPageToken String ea04afcca7cd4e80b9ece8fbb251****

下一页标识。

CensorResults Array of CensorResult

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

CensorResult
Suggestion String review

处理建议。取值:

  • pass:通过。
  • review:人工重审。
  • block:拦截。
Label String meaningless

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

  • 图片鉴黄(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:含商标。
Scene String terrorism

审核场景。

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

分值。

PipelineId String c5b30b7c0d0e4a0abde1d5f9e751****

管道ID。

RequestId String D1D5C080-8E2F-5030-8AB4-13092F17631B

请求ID。

NextPageToken String 9b1a42bc6e8d46e6a1383b7e7f01****

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

NonExistIds Array of String 78dc866518b843259669df58ed30****

作业ID。

示例

请求示例

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=QueryMediaCensorJobList
&JobIds=fa9c34be3bcf42919ac4d1775239****,78dc866518b843259669df58ed30****
&NextPageToken=79aff3eee82242e092899db5f669****
&MaximumPageSize=20
&State=All
&StartOfJobCreatedTimeRange=2021-12-22T03:48:05Z
&EndOfJobCreatedTimeRange=2022-02-14T02:16:07Z
&PipelineId=c5b30b7c0d0e4a0abde1d5f9e751****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "MediaCensorJobList" : [ {
    "CreationTime" : "2021-11-04T07:25:48Z",
    "FinishTime" : "2021-11-04T07:25:48Z",
    "Suggestion" : "pass",
    "CoverImageCensorResults" : [ {
      "Object" : "test/ai/censor/v2/vme-****.jpg",
      "Location" : "oss-cn-shanghai",
      "Bucket" : "example-Bucket-****",
      "Results" : [ {
        "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" : [ {
        "Timestamp" : "00:02:59.999",
        "Object" : "output{Count}.jpg",
        "CensorResults" : [ {
          "Suggestion" : "block",
          "Label" : "normal",
          "Scene" : "pron",
          "Rate" : "99.99"
        } ]
      } ],
      "NextPageToken" : "ea04afcca7cd4e80b9ece8fbb251****",
      "CensorResults" : [ {
        "Suggestion" : "review",
        "Label" : "meaningless",
        "Scene" : "terrorism",
        "Rate" : "100"
      } ]
    },
    "PipelineId" : "c5b30b7c0d0e4a0abde1d5f9e751****"
  } ],
  "RequestId" : "D1D5C080-8E2F-5030-8AB4-13092F17631B",
  "NextPageToken" : "9b1a42bc6e8d46e6a1383b7e7f01****",
  "NonExistIds" : [ "78dc866518b843259669df58ed30****" ]
}

错误码

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