调用QueryMediaCensorJobDetail查询媒体审核作业的详细信息。
接口说明
媒体审核结果中视频部分是按照时间点从小到大排序组成一个时间线,如果视频时间非常长,查询时按分页返回第 1 页信息,如果需要详细查询视频部分的全量结果,可单独调用本接口。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ice:QueryMediaCensorJobDetail |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| JobId |
string |
是 |
媒体审核作业 ID。可以从提交媒体审核作业的返回参数中获取。 |
2288c6ca184c0e47098a5b665e2a12**** |
| NextPageToken |
string |
否 |
下一页标识,第一次提交时为空即可。下一页标识将在第一次查询后返回。 |
ae0fd49c0840e14daf0d66a75b83**** |
| MaximumPageSize |
integer |
否 |
每页最大返回数。
|
30 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回参数。 |
||
| RequestId |
string |
请求 ID。 |
B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA |
| MediaCensorJobDetail |
object |
媒体审核作业结果列表。 |
|
| CreationTime |
string |
创建时间。 |
2018-09-13T16:32:24Z |
| FinishTime |
string |
完成时间。 |
2018-09-13T16:38:24Z |
| Suggestion |
string |
作业整体审核结果。取值:
说明
任何一种类型的审核结果是 review 时,整体结果为 review,任何一种类型的审核结果是 block 时,整体结果为 block。 |
block |
| CoverImageCensorResults |
object |
||
| CoverImageCensorResult |
array<object> |
封面审核结果。 |
|
|
array<object> |
结果详细信息。 |
||
| Object |
string |
视频封面 OSS Object。 |
test/ai/censor/v2/vme-****.jpg |
| Location |
string |
视频封面 OSS Location。 |
oss-cn-shanghai |
| Bucket |
string |
视频封面 OSS Bucket。 |
bucket-out-test-**** |
| Results |
object |
||
| Result |
array<object> |
审核结果。 |
|
|
object |
审核结果详细信息。 |
||
| Suggestion |
string |
处理建议。取值:
|
pass |
| Label |
string |
审核结果的标签。
|
Normal |
| Scene |
string |
审核场景。
|
Antispam |
| Rate |
string |
分值。取值:0~100。 |
100 |
| State |
string |
作业状态。 |
Success |
| TitleCensorResult |
object |
标题审核结果。 |
|
| Suggestion |
string |
处理建议。取值:
|
block |
| Label |
string |
审核结果的标签。
|
meaningless |
| Scene |
string |
审核场景。取固定值: antispam,文本反垃圾。 |
antispam |
| Rate |
string |
分值。 |
99.91 |
| Message |
string |
作业失败时错误信息。执行成功时不返回此参数。 |
The resource operated cannot be found |
| Input |
object |
作业输入。 |
|
| Object |
string |
输入文件的 OSS Object。 |
test/ai/censor/test-****.mp4 |
| Location |
string |
输入文件的 OSS Location。 |
oss-cn-shanghai |
| Bucket |
string |
输入文件的 OSS Bucket。 |
bucket-test-in-**** |
| BarrageCensorResult |
object |
弹幕审核结果。 |
|
| Suggestion |
string |
处理建议。取值:
|
pass |
| Label |
string |
审核结果的标签。
|
normal |
| Scene |
string |
审核场景。取固定值: antispam,文本反垃圾。 |
antispam |
| Rate |
string |
分值。 |
99.91 |
| DescCensorResult |
object |
描述审核结果。 |
|
| Suggestion |
string |
处理建议。取值:
|
review |
| Label |
string |
审核结果的标签。
|
terrorism |
| Scene |
string |
审核场景。取固定值: antispam,文本反垃圾。 |
antispam |
| Rate |
string |
分值。 |
100 |
| VideoCensorConfig |
object |
视频审查配置。 |
|
| OutputFile |
object |
视频截图结果的保存地址。 |
|
| Object |
string |
截图输出文件 (OSS Object)。 说明
示例中{Count}是占位符,图片 Object 依次为 |
output{Count}.jpg |
| Location |
string |
截图输出 OSS Bucket 所在数据中心(OSS Location)。 |
oss-cn-shanghai |
| Bucket |
string |
截图输出文件所在 OSS Bucket。 |
test-bucket-**** |
| VideoCensor |
string |
是否需要审核视频内容。默认值:true。可取值:
|
true |
| BizType |
string |
定制业务类型。默认 common。 |
common |
| JobId |
string |
媒体审核作业 ID。 |
f8f166eea7a44e9bb0a4aecf9543**** |
| UserData |
string |
用户自定义数据。 |
example userdata **** |
| Code |
string |
作业失败时错误码。执行成功时此参数不返回。 |
InvalidParameter.ResourceNotFound |
| VensorCensorResult |
object |
视频审查结果。 |
|
| VideoTimelines |
object |
||
| VideoTimeline |
array<object> |
详细时间点的审核结果,按照时间从小到大排序。 |
|
|
array<object> |
返回参数。 |
||
| Timestamp |
string |
视频中的位置。
格式: |
00:02:59.999 |
| Object |
string |
截图输出文件 (OSS Object)。 说明
示例中{Count}是占位符,图片 Object 依次为 |
output{Count}.jpg |
| CensorResults |
object |
||
| CensorResult |
array<object> |
包含多种类型审核结果的标签、分值等。 |
|
|
object |
返回参数。 |
||
| Suggestion |
string |
处理建议。取值:
|
block |
| Label |
string |
审核结果的标签。
|
flood |
| Scene |
string |
审核场景。
|
porn |
| Rate |
string |
分值。 |
99.99 |
| NextPageToken |
string |
下一页标识 |
ea04afcca7cd4e80b9ece8fbb251**** |
| CensorResults |
object |
||
| CensorResult |
array<object> |
审核结果集合,包含各种场景(黄、暴、恐、政)的概要信息。 |
|
|
object |
审核结果详情。 |
||
| Suggestion |
string |
处理建议。取值:
|
review |
| Label |
string |
审核结果的标签。
|
meaningless |
| Scene |
string |
审核场景。
|
terrorism |
| Rate |
string |
分值。 |
100 |
| PipelineId |
string |
管道 ID。 |
c5b30b7c0d0e4a0abde1d5f9e751**** |
示例
正常返回示例
JSON格式
{
"RequestId": "B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA",
"MediaCensorJobDetail": {
"CreationTime": "2018-09-13T16:32:24Z",
"FinishTime": "2018-09-13T16:38:24Z",
"Suggestion": "block",
"CoverImageCensorResults": {
"CoverImageCensorResult": [
{
"Object": "test/ai/censor/v2/vme-****.jpg",
"Location": "oss-cn-shanghai",
"Bucket": "bucket-out-test-****",
"Results": {
"Result": [
{
"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": "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": {
"VideoTimeline": [
{
"Timestamp": "00:02:59.999",
"Object": "output{Count}.jpg",
"CensorResults": {
"CensorResult": [
{
"Suggestion": "block",
"Label": "flood",
"Scene": "porn",
"Rate": "99.99"
}
]
}
}
]
},
"NextPageToken": "ea04afcca7cd4e80b9ece8fbb251****",
"CensorResults": {
"CensorResult": [
{
"Suggestion": "review",
"Label": "meaningless",
"Scene": "terrorism",
"Rate": "100"
}
]
}
},
"PipelineId": "c5b30b7c0d0e4a0abde1d5f9e751****"
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。