调用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	审核结果的标签，多个使用半角逗号（,）分隔。图片智能鉴黄（porn）审核结果分类： normal：正常。 sexy：性感。 porn：色情。图片暴恐涉政（terrorism）结果分类： narmal：正常。 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	porn	审核场景。 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	review	处理建议。可取值： pass：通过 review：人工重审 block：拦截
Label	String	normal	审核结果分类。取值： 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。
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	porn,ad	审核结果分类，多个使用半角逗号（,）分隔。取值：图片鉴黄（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	porn	审核场景。 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。

示例

请求示例

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=QueryMediaCensorJobDetail
&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>porn</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>normal</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>porn,ad</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" : "porn",
        "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" : "normal",
      "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" : "porn,ad",
          "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"
    }
]

错误码

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