调用QueryMediaCensorJobDetail查询媒体审核作业的详细信息。

使用说明

媒体审核结果中视频部分是按照时间点从小到大排序组成一个时间线,如果视频时间非常长,查询时 按分页返回第1页信息,如果需要详细查询视频部分的全量结果,可单独调用本接口。

QPS限制

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

调试

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

请求参数

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

操作接口名,系统规定参数,取值: QueryMediaCensorJobDetail

JobId String 2288c6ca184c0e47098a5b665e2a12****

媒体审核作业ID。可以从提交媒体审核作业的返回参数中获取。

NextPageToken String ae0fd49c0840e14daf0d66a75b83****

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

MaximumPageSize Long 30

每页最大返回数。

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

返回数据

名称 类型 示例值 描述
RequestId String B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA

请求ID。

MediaCensorJobDetail Object

媒体审核作业结果列表。

CreationTime String 2018-09-13T16:32:24Z

创建时间。

FinishTime String 2018-09-21

完成时间。

Suggestion String Block

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

  • Pass:通过
  • Review:人工重审
  • Block:拦截

任何一种类型的审核结果是Review时,整体结果为Review,任何一种类型的审核结果是Block时,整体结果为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 bucket-out-test-****

视频封面OSS Bucket。

Results Array of Result

审核结果。

Result
Suggestion String Pass

处理建议。取值:

  • Pass:通过
  • Review:人工重审
  • Block:拦截
Label String Normal

审核结果的标签。

  • Normal:普通
  • Spam:含垃圾信息
  • Ad:广告
  • Politics:涉政
  • Terrorism:暴恐
  • Abuse:辱骂
  • Flood:灌水
  • Contraband:违禁
  • Meaningless:无意义
  • Porn:色情
  • Sexy:性感
  • Outfit:特殊装束
  • Logo:特殊标识
  • Weapon:武器
  • Politic:渉政
  • Others:其它
Scene String Antispam

审核场景。

  • Antispam:文本反垃圾
  • Porn:色情
  • Terrorism:暴恐涉政
Rate String 100

分值。取值:0~100

State String Success

作业状态。

TitleCensorResult Object

标题审核结果。

Suggestion String Block

处理建议。取值:

  • Pass:通过,
  • Review:人工重审,
  • Block:拦截。
Label String Meaningless

审核结果的标签。

  • Normal:普通
  • Spam:含垃圾信息
  • Ad:广告
  • Politics:涉政
  • Terrorism:暴恐
  • Abuse:辱骂
  • Flood:灌水
  • Contraband:违禁
  • Meaningless:无意义
  • Porn:色情
  • Sexy:性感
  • Outfit:特殊装束
  • Logo:特殊标识
  • Weapon:武器
  • Politic:渉政
  • Others:其它
Scene String Antispam

审核场景。

  • Antispam:文本反垃圾
  • Porn:色情
  • Terrorism:暴恐涉政
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

审核结果的标签。

  • 图片智能鉴黄(porn)结果分类:
    • normal:正常
    • sexy:性感
    • porn:色情
  • 图片暴恐涉政(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 Antispam

审核场景。

  • Antispam:文本反垃圾
  • Porn:色情
  • Terrorism:暴恐涉政
Rate String 99.91

分值。

DescCensorResult Object

描述审核结果。

Suggestion String Review

处理建议。可取值:

  • Pass:通过
  • Review:人工重审
  • Block:拦截
Label String Terrorism

审核结果的标签。

  • Normal:普通
  • Spam:含垃圾信息
  • Ad:广告
  • Politics:涉政
  • Terrorism:暴恐
  • Abuse:辱骂
  • Flood:灌水
  • Contraband:违禁
  • Meaningless:无意义
  • Porn:色情
  • Sexy:性感
  • Outfit:特殊装束
  • Logo:特殊标识
  • Weapon:武器
  • Politic:渉政
  • Others:其它
Scene String Terrorism

审核场景。

  • Antispam:文本反垃圾
  • Porn:色情
  • Terrorism:恐怖涉政
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。

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 Flood

审核结果的标签。

  • Normal:普通
  • Spam:含垃圾信息
  • Ad:广告
  • Politics:涉政
  • Terrorism:暴恐
  • Abuse:辱骂
  • Flood:灌水
  • Contraband:违禁
  • Meaningless:无意义
  • Porn:色情
  • Sexy:性感
  • Outfit:特殊装束
  • Logo:特殊标识
  • Weapon:武器
  • Politic:渉政
  • Others:其它
Scene String Porn

审核场景。

  • Antispam:文本反垃圾
  • Porn:色情
  • Terrorism:恐怖涉政
Rate String 99.99

分值。

NextPageToken String ea04afcca7cd4e80b9ece8fbb251****

下一页标识。

CensorResults Array of CensorResult

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

CensorResult
Suggestion String Review

处理建议。取值:

  • Pass:通过,
  • Review:人工重审,
  • Block:拦截。
Label String Meaningless

审核结果的标签。

  • Normal:普通
  • Spam:含垃圾信息
  • Ad:广告
  • Politics:涉政
  • Terrorism:暴恐
  • Abuse:辱骂
  • Flood:灌水
  • Contraband:违禁
  • Meaningless:无意义
  • Porn:色情
  • Sexy:性感
  • Outfit:特殊装束
  • Logo:特殊标识
  • Weapon:武器
  • Politic:渉政
  • Others:其它
Scene String Terrorism

审核场景。

  • Antispam:文本反垃圾,
  • Porn:色情,
  • Terrorism:暴恐涉政。
Rate String 100

分值。

PipelineId String c5b30b7c0d0e4a0abde1d5f9e751****

管道ID。

示例

请求示例

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=QueryMediaCensorJobDetail
&ResourceOwnerId=1
&JobId=2288c6ca184c0e47098a5b665e2a12****
&NextPageToken=ae0fd49c0840e14daf0d66a75b83****
&MaximumPageSize=30
&<公共请求参数>

正常返回示例

XML格式

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

<QueryMediaCensorJobDetailResponse>
    <RequestId>B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA</RequestId>
    <MediaCensorJobDetail>
        <CreationTime>2018-09-13T16:32:24Z</CreationTime>
        <FinishTime>2018-09-21</FinishTime>
        <Suggestion>Block</Suggestion>
        <CoverImageCensorResults>
            <Object>test/ai/censor/v2/vme-****.jpg</Object>
            <Location>oss-cn-shanghai</Location>
            <Bucket>bucket-out-test-****</Bucket>
            <Results>
                <Suggestion>Pass</Suggestion>
                <Label>Normal</Label>
                <Scene>Antispam</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>Review</Suggestion>
            <Label>Terrorism</Label>
            <Scene>Terrorism</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>Flood</Label>
                    <Scene>Porn</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>
    </MediaCensorJobDetail>
</QueryMediaCensorJobDetailResponse>

JSON格式

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

{
  "RequestId" : "B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA",
  "MediaCensorJobDetail" : {
    "CreationTime" : "2018-09-13T16:32:24Z",
    "FinishTime" : "2018-09-21",
    "Suggestion" : "Block",
    "CoverImageCensorResults" : [ {
      "Object" : "test/ai/censor/v2/vme-****.jpg",
      "Location" : "oss-cn-shanghai",
      "Bucket" : "bucket-out-test-****",
      "Results" : [ {
        "Suggestion" : "Pass",
        "Label" : "Normal",
        "Scene" : "Antispam",
        "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" : "Review",
      "Label" : "Terrorism",
      "Scene" : "Terrorism",
      "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" : "Flood",
          "Scene" : "Porn",
          "Rate" : "99.99"
        } ]
      } ],
      "NextPageToken" : "ea04afcca7cd4e80b9ece8fbb251****",
      "CensorResults" : [ {
        "Suggestion" : "Review",
        "Label" : "Meaningless",
        "Scene" : "Terrorism",
        "Rate" : "100"
      } ]
    },
    "PipelineId" : "c5b30b7c0d0e4a0abde1d5f9e751****"
  }
}

返回示例补充说明

//  videoTimeline示例
//  审核完成后系统会输出一个审核结果的JSON文件至提交媒体审核作业接口中CensorConfig.OutputFile所指定的oss中,文件名为{jobId}.video_timeline 示例如下:
[
    {
        "CensorResults":[
            {
                "Label":"ad",
                "Rate":"99.9100000000",
                "Scene":"ad"
            }
        ],
        "Object":"gaoshen/test8/example-00001.jpg",
        "Timestamp":"00:00:00.005"
    },
    {
        "CensorResults":[
            {
                "Label":"ad",
                "Rate":"99.9100000000",
                "Scene":"ad"
            }
        ],
        "Object":"gaoshen/test8/example-00002.jpg",
        "Timestamp":"00:00:05.005"
    },
    {
        "CensorResults":[
            {
                "Label":"ad",
                "Rate":"99.9100000000",
                "Scene":"ad"
            }
        ],
        "Object":"gaoshen/test8/example-00003.jpg",
        "Timestamp":"00:00:10.005"
    },
    {
        "CensorResults":[
            {
                "Label":"ad",
                "Rate":"99.9100000000",
                "Scene":"ad"
            }
        ],
        "Object":"gaoshen/test8/example-00004.jpg",
        "Timestamp":"00:00:15.005"
    },
    {
        "CensorResults":[
            {
                "Label":"politics",
                "Rate":"82.6500000000",
                "Scene":"terrorism",
                "SfaceData":[
                    {
                        "faces":[
                            {
                                "id":"AliFace_0006942",
                                "name":"名字",
                                "rate":82.65
                            }
                        ],
                        "h":51,
                        "w":40,
                        "x":744,
                        "y":121
                    }
                ]
            }
        ],
        "Object":"gaoshen/test8/example-00008.jpg",
        "Timestamp":"00:00:35.005"
    },
    {
        "CensorResults":[
            {
                "Label":"politics",
                "Rate":"93.6800000000",
                "Scene":"terrorism",
                "SfaceData":[
                    {
                        "faces":[
                            {
                                "id":"AliFace_0006942",
                                "name":"名字",
                                "rate":93.68
                            }
                        ],
                        "h":119,
                        "w":94,
                        "x":662,
                        "y":94
                    }
                ]
            }
        ],
        "Object":"gaoshen/test8/example-00011.jpg",
        "Timestamp":"00:00:50.005"
    },
    {
        "CensorResults":[
            {
                "Label":"ad",
                "Rate":"99.9100000000",
                "Scene":"ad"
            }
        ],
        "Object":"gaoshen/test8/example-00011.jpg",
        "Timestamp":"00:00:50.005"
    },
    {
        "CensorResults":[
            {
                "Label":"politics",
                "Rate":"89.2900000000",
                "Scene":"terrorism",
                "SfaceData":[
                    {
                        "faces":[
                            {
                                "id":"AliFace_0006942",
                                "name":"名字",
                                "rate":89.29
                            }
                        ],
                        "h":112,
                        "w":98,
                        "x":665,
                        "y":138
                    }
                ]
            }
        ],
        "Object":"gaoshen/test8/example-00012.jpg",
        "Timestamp":"00:00:55.005"
    },
    {
        "CensorResults":[
            {
                "Label":"ad",
                "Rate":"99.9100000000",
                "Scene":"ad"
            }
        ],
        "Object":"gaoshen/test8/example-00012.jpg",
        "Timestamp":"00:00:55.005"
    },
    {
        "CensorResults":[
            {
                "Label":"politics",
                "Rate":"92.1400000000",
                "Scene":"terrorism",
                "SfaceData":[
                    {
                        "faces":[
                            {
                                "id":"AliFace_0007536",
                                "name":"名字",
                                "rate":92.14
                            }
                        ],
                        "h":117,
                        "w":91,
                        "x":665,
                        "y":79
                    }
                ]
            }
        ],
        "Object":"gaoshen/test8/example-00013.jpg",
        "Timestamp":"00:01:00.005"
    },
    {
        "CensorResults":[
            {
                "Label":"ad",
                "Rate":"99.9100000000",
                "Scene":"ad"
            }
        ],
        "Object":"gaoshen/test8/example-00013.jpg",
        "Timestamp":"00:01:00.005"
    },
    {
        "CensorResults":[
            {
                "Label":"politics",
                "Rate":"93.0400000000",
                "Scene":"terrorism",
                "SfaceData":[
                    {
                        "faces":[
                            {
                                "id":"AliFace_0002750",
                                "name":"名字",
                                "rate":93.04
                            }
                        ],
                        "h":120,
                        "w":93,
                        "x":673,
                        "y":79
                    }
                ]
            }
        ],
        "Object":"gaoshen/test8/example-00014.jpg",
        "Timestamp":"00:01:05.005"
    }
]

错误码

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