调用QueryMediaCensorJobDetail查询媒体审核作业的详细信息。
媒体审核结果中视频部分是按照时间点从小到大排序组成一个时间线，如果视频时间非常长，查询媒体审核按分页返回第1页信息，如果需要详细查询视频部分的全量结果，可单独调用本接口。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 否 | QueryMediaCensorJobDetail |
操作接口名，系统规定参数，取值： QueryMediaCensorJobDetail。 |
| JobId | String | 是 | 2288c6ca184c0e47098a5b665e2a126797 |
媒体审核作业ID。 |
| NextPageToken | String | 否 | 1 |
下一页标识，空表示第1页，下一页标识将在第一次查询后返回。 |
| MaximumPageSize | Long | 否 | 30 |
每页最大返回数。
|
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| MediaCensorJobDetail | Struct |
媒体审核作业结果列表。 |
|
| BarrageCensorResult | Struct |
弹幕审核结果。 |
|
| Label | String | Normal |
审核结果的标签。
|
| Rate | String | 99.91 |
分值。 取值：0~100 |
| Scene | String | Antispam |
审核场景。
|
| Suggestion | String | Pass |
处理建议。取值：
|
| Code | String | 1 |
作业失败时错误码。 |
| CoverImageCensorResults | Array of CoverImageCensorResult |
封面审核结果。 |
|
| CoverImageCensorResult | |||
| Bucket | String | bucket-out-test |
视频封面OSS Bucket。 |
| Location | String | oss-cn-shanghai |
视频封面OSS Location。 |
| Object | String | test/ai/censor/v2/vme.jpg |
视频封面OSS Object。 |
| Results | Array of Result |
审核结果。 |
|
| Result | |||
| Label | String | Normal |
审核结果的标签。
|
| Rate | String | 100 |
分值。取值：0~100 |
| Scene | String | Antispam |
审核场景。
|
| Suggestion | String | Pass |
处理建议。取值：
|
| CreationTime | String | 2018-09-13T16:32:24Z | |
| DescCensorResult | Struct |
描述审核结果 |
|
| Label | String | Terrorism |
审核结果的标签。
|
| Rate | String | 100 |
分值。 取值：0~100 |
| Scene | String | Terrorism |
审核场景。
|
| Suggestion | String | Review |
处理建议。取值：
|
| FinishTime | String | 2018-09-21 | |
| Input | Struct |
作业输入。 |
|
| Bucket | String | bucket-test-in |
OSS的Bucket。 |
| Location | String | oss-cn-shanghai |
OSS的服务区域。最大64字节。 |
| Object | String | test/ai/censor/鉴黄视频4-2.mp4 |
OSS的Object。最大1024字节。 |
| JobId | String | f8f166eea7a44e9bb0a4aecf9543a793 |
媒体审核作业ID。 |
| Message | String | 1 |
作业失败时错误信息。 |
| PipelineId | String | c5b30b7c0d0e4a0abde1d5f9e751a772 |
管道ID。 |
| State | String | Success |
作业状态。 |
| Suggestion | String | block |
作业整体审核结果。取值：
任何一种类型的审核结果是Review时，整体结果为Review，任何一种类型的审核结果是Block时，整体结果为Block 。 |
| TitleCensorResult | Struct |
标题审核结果。 |
|
| Label | String | Meaningless |
审核结果的标签。
|
| Rate | String | 99.91 |
分值。范围： |
| Scene | String | Antispam |
审核场景。
|
| Suggestion | String | Block |
处理建议。取值：
|
| UserData | String | 1 |
用户自定义数据。 |
| VensorCensorResult | Struct |
视频审查结果。 |
|
| CensorResults | Array of CensorResult |
审核结果集合，包含各种场景（黄、恐、暴、政）的概要信息。 |
|
| CensorResult | |||
| Label | String | Meaningless |
审核结果的标签。
|
| Rate | String | 100 |
分值。范围： |
| Scene | String | Terrorism |
审核场景。
|
| Suggestion | String | Review |
处理建议。取值：
|
| NextPageToken | String | 1 |
下一页标识，32位UUID。 |
| VideoTimelines | Array of VideoTimeline |
详细时间点的审核结果，按照时间从小到大排序。 |
|
| VideoTimeline | |||
| CensorResults | Array of CensorResult |
包含多种类型审核结果的标签、分值等。 |
|
| CensorResult | |||
| Label | String | Flood |
审核结果的标签。
|
| Rate | String | 99.99 |
分值。取值：0~100 |
| Scene | String | Porn |
审核场景。
|
| Suggestion | String | Block |
处理建议。取值：
|
| Object | String | test/ai/censor/v2/vs-00001.jpg |
截图OSS存储路径。 |
| Timestamp | String | 00:02:59.999 |
视频中的位置。 格式： |
| VideoCensorConfig | Struct |
视频审查配置。 |
|
| BizType | String | common |
定制业务类型。默认common。 |
| OutputFile | Struct |
视频截图结果的保存地址。 |
|
| Bucket | String | test-bucket |
截图输出文件所在OSS Bucket。 |
| Location | String | oss-cn-shanghai |
截图输出OSS Bucket所在数据中心（OSS Location） |
| Object | String | output{Count}.jpg |
截图输出文件 （OSS Object） 说明 示例中{Count}是占位符，图片Object依次为output00001.jpg,output00002.jpg等。
|
| VideoCensor | String | true |
是否需要审核视频内容。默认值：true。 设置为false时，必须确保相同的媒体输入文件之前提交过作业，并且是执行成功状态，否则这次请求会被拒绝。 |
| RequestId | String | B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=QueryMediaCensorJobDetail
&JobId=2288c6ca184c0e47098a5b665e2a126797
&<公共请求参数>正常返回示例
XML格式
<RequestId>B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA</RequestId>
<MediaCensorJobDetail>
<Message/>
<UserData/>
<DescCensorResult>
<Suggestion>Review</Suggestion>
<Rate>100</Rate>
<Label>Terrorism</Label>
<Scene>Terrorism</Scene>
</DescCensorResult>
<Code/>
<CoverImageCensorResults>
<CoverImageCensorResult>
<Object>test/ai/censor/v2/vme.jpg</Object>
<Bucket>bucket-out-test</Bucket>
<Location>oss-cn-shanghai</Location>
</CoverImageCensorResult>
<CoverImageCensorResult>
<Results>
<Result>
<Label>Normal</Label>
<Suggestion>Pass</Suggestion>
<Scene>Antispam</Scene>
<Rate>100</Rate>
</Result>
</Results>
</CoverImageCensorResult>
</CoverImageCensorResults>
<Suggestion>block</Suggestion>
<Input>
<Bucket>bucket-test-in</Bucket>
<Object>test/ai/censor/鉴黄视频4-2.mp4</Object>
<Location>oss-cn-shanghai</Location>
</Input>
<FinishTime/>
<State>Success</State>
<VensorCensorResult>
<CensorResults>
<CensorResult>
<Label>Meaningless</Label>
<Suggestion>Review</Suggestion>
<Scene>Terrorism</Scene>
<Rate>100</Rate>
</CensorResult>
</CensorResults>
<NextPageToken>1</NextPageToken>
<VideoTimelines>
<VideoTimeline>
<Timestamp>00:02:59.999</Timestamp>
<Object>test/ai/censor/v2/vs-00001.jpg</Object>
</VideoTimeline>
<VideoTimeline>
<CensorResults>
<CensorResult>
<Label>Flood</Label>
<Suggestion>Block</Suggestion>
<Scene>Porn</Scene>
<Rate>99.99</Rate>
</CensorResult>
</CensorResults>
</VideoTimeline>
</VideoTimelines>
</VensorCensorResult>
<CreationTime>2018-09-13T16:32:24Z</CreationTime>
<BarrageCensorResult>
<Suggestion>Pass</Suggestion>
<Rate>99.91</Rate>
<Label>Normal</Label>
<Scene>Antispam</Scene>
</BarrageCensorResult>
<PipelineId>c5b30b7c0d0e4a0abde1d5f9e751a772</PipelineId>
<VideoCensorConfig>
<OutputFile>
<Bucket>test-bucket</Bucket>
<Object>output{Count}.jpg</Object>
<Location>oss-cn-shanghai</Location>
</OutputFile>
<VideoCensor>true</VideoCensor>
<BizType>common</BizType>
</VideoCensorConfig>
<JobId>f8f166eea7a44e9bb0a4aecf9543a793</JobId>
<TitleCensorResult>
<Suggestion>Block</Suggestion>
<Rate>99.91</Rate>
<Label>Meaningless</Label>
<Scene>Antispam</Scene>
</TitleCensorResult>
</MediaCensorJobDetail>JSON格式
{
"RequestId": "B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA",
"MediaCensorJobDetail": {
"Message": "",
"UserData": "",
"DescCensorResult": {
"Suggestion": "Review",
"Rate": 100,
"Label": "Terrorism",
"Scene": "Terrorism"
},
"Code": "",
"CoverImageCensorResults": {
"CoverImageCensorResult": [
{
"Object": "test/ai/censor/v2/vme.jpg",
"Bucket": "bucket-out-test",
"Location": "oss-cn-shanghai"
},
{
"Results": {
"Result": {
"Label": "Normal",
"Suggestion": "Pass",
"Scene": "Antispam",
"Rate": 100
}
}
}
]
},
"Suggestion": "block",
"Input": {
"Bucket": "bucket-test-in",
"Object": "test/ai/censor/鉴黄视频4-2.mp4",
"Location": "oss-cn-shanghai"
},
"FinishTime": "",
"State": "Success",
"VensorCensorResult": {
"CensorResults": {
"CensorResult": {
"Label": "Meaningless",
"Suggestion": "Review",
"Scene": "Terrorism",
"Rate": 100
}
},
"NextPageToken": 1,
"VideoTimelines": {
"VideoTimeline": [
{
"Timestamp": "00:02:59.999",
"Object": "test/ai/censor/v2/vs-00001.jpg"
},
{
"CensorResults": {
"CensorResult": {
"Label": "Flood",
"Suggestion": "Block",
"Scene": "Porn",
"Rate": 99.99
}
}
}
]
}
},
"CreationTime": "2018-09-13T16:32:24Z",
"BarrageCensorResult": {
"Suggestion": "Pass",
"Rate": 99.91,
"Label": "Normal",
"Scene": "Antispam"
},
"PipelineId": "c5b30b7c0d0e4a0abde1d5f9e751a772",
"VideoCensorConfig": {
"OutputFile": {
"Bucket": "test-bucket",
"Object": "output{Count}.jpg",
"Location": "oss-cn-shanghai"
},
"VideoCensor": true,
"BizType": "common"
},
"JobId": "f8f166eea7a44e9bb0a4aecf9543a793",
"TitleCensorResult": {
"Suggestion": "Block",
"Rate": 99.91,
"Label": "Meaningless",
"Scene": "Antispam"
}
}
}错误码
访问错误中心查看更多错误码。
审核完成后系统会输出一个审核结果的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"
}
]
说明 其中
Timestamp为截图的时间，Object为截图保存的oss路径，其他格式和字段说明，请参见查询媒体审核作业详情的返回数据说明。
在文档使用中是否遇到以下问题
更多建议
匿名提交