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

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

调试

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

请求参数

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

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

JobId String 2288c6ca184c0e47098a5b665e2a126797

媒体审核作业ID。

NextPageToken String 1

下一页标识,空表示第1页,下一页标识将在第一次查询后返回。

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

分值。范围:[0,100]

Message String 1

作业失败时错误信息。

Input Object

作业输入。

Object String test/ai/censor/鉴黄视频4-2.mp4

OSS的Object。最大1024字节。

Location String oss-cn-shanghai

OSS的服务区域。最大64字节。

Bucket String bucket-test-in

OSS的Bucket。3~63字节。

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

分值。

取值:0~100

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

分值。

取值:0~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

设置为false时,必须确保相同的媒体输入文件之前提交过作业,并且是执行成功状态,否则这次请求会被拒绝。

BizType String common

定制业务类型。默认common。

JobId String f8f166eea7a44e9bb0a4aecf9543a793

媒体审核作业ID。

UserData String 1

用户自定义数据。

Code String 1

作业失败时错误码。

VensorCensorResult Object

视频审查结果。

VideoTimelines Array of VideoTimeline

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

VideoTimeline
Timestamp String 00:02:59.999

视频中的位置。

格式:hh:mm:ss[.SSS]

Object String test/ai/censor/v2/vs-00001.jpg

截图OSS存储路径。

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

分值。取值:0~100

NextPageToken String 1

下一页标识,32位UUID。

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

分值。范围:[0,100]

PipelineId String c5b30b7c0d0e4a0abde1d5f9e751a772

管道ID。

示例

请求示例

http(s)://[Endpoint]/?AccessKeyId=xxx
&Action=QueryMediaCensorJobDetail
&JobId=2288c6ca184c0e47098a5b665e2a126797
&NextPageToken=1
&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>1</Message>
        <Input>
            <Object>test/ai/censor/鉴黄视频4-2.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>f8f166eea7a44e9bb0a4aecf9543a793</JobId>
        <UserData>1</UserData>
        <Code>1</Code>
        <VensorCensorResult>
            <VideoTimelines>
                <Timestamp>00:02:59.999</Timestamp>
                <Object>test/ai/censor/v2/vs-00001.jpg</Object>
                <CensorResults>
                    <Suggestion>Block</Suggestion>
                    <Label>Flood</Label>
                    <Scene>Porn</Scene>
                    <Rate>99.99</Rate>
                </CensorResults>
            </VideoTimelines>
            <NextPageToken>1</NextPageToken>
            <CensorResults>
                <Suggestion>Review</Suggestion>
                <Label>Meaningless</Label>
                <Scene>Terrorism</Scene>
                <Rate>100</Rate>
            </CensorResults>
        </VensorCensorResult>
        <PipelineId>c5b30b7c0d0e4a0abde1d5f9e751a772</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" : 1,
    "Input" : {
      "Object" : "test/ai/censor/鉴黄视频4-2.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" : "f8f166eea7a44e9bb0a4aecf9543a793",
    "UserData" : 1,
    "Code" : 1,
    "VensorCensorResult" : {
      "VideoTimelines" : {
        "Timestamp" : "00:02:59.999",
        "Object" : "test/ai/censor/v2/vs-00001.jpg",
        "CensorResults" : {
          "Suggestion" : "Block",
          "Label" : "Flood",
          "Scene" : "Porn",
          "Rate" : 99.99
        }
      },
      "NextPageToken" : 1,
      "CensorResults" : {
        "Suggestion" : "Review",
        "Label" : "Meaningless",
        "Scene" : "Terrorism",
        "Rate" : 100
      }
    },
    "PipelineId" : "c5b30b7c0d0e4a0abde1d5f9e751a772"
  }
}

返回示例补充说明

//  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"
    }
]

错误码

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