查询媒体审核作业列表。
接口说明
本接口只支持查询三个月内的媒体审核作业列表。
QPS 限制
本接口的单用户 QPS 限制为 100 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| mts:QueryMediaCensorJobList | get |
|
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| JobIds | string | 否 | 媒体审核作业 ID。可以从提交媒体审核作业的返回参数中获取，多个使用半角逗号（,）分隔。 | fa9c34be3bcf42919ac4d1775239****,78dc866518b843259669df58ed30**** |
| NextPageToken | string | 否 | 下一页标识，第一次提交时为空即可。下一页标识将在第一次查询后返回。 | 79aff3eee82242e092899db5f669**** |
| MaximumPageSize | long | 否 | 每页最大返回数。
| 20 |
| State | string | 否 | 需要查询的作业状态。取值：
| All |
| StartOfJobCreatedTimeRange | string | 否 | 最早任务创建时间。
| 2021-12-22T03:48:05Z |
| EndOfJobCreatedTimeRange | string | 否 | 最晚任务创建时间。
| 2022-02-14T02:16:07Z |
| PipelineId | string | 否 | 管道 ID。可以通过媒体处理控制台 > 全局设置 > 管道及回调获取。 | c5b30b7c0d0e4a0abde1d5f9e751**** |
返回参数
示例
正常返回示例
JSON格式
{
"MediaCensorJobList": {
"MediaCensorJob": [
{
"CreationTime": "2021-11-04T07:25:48Z",
"FinishTime": "2021-11-04T07:25:48Z",
"Suggestion": "pass",
"CoverImageCensorResults": {
"CoverImageCensorResult": [
{
"Object": "test/ai/censor/v2/vme-****.jpg",
"Location": "oss-cn-shanghai",
"Bucket": "example-Bucket-****",
"Results": {
"Result": [
{
"Suggestion": "pass",
"Label": "normal",
"Scene": "live",
"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": "pass",
"Label": "ad",
"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": "normal",
"Scene": "pron",
"Rate": "99.99"
}
]
}
}
]
},
"NextPageToken": "ea04afcca7cd4e80b9ece8fbb251****",
"CensorResults": {
"CensorResult": [
{
"Suggestion": "review",
"Label": "meaningless",
"Scene": "terrorism",
"Rate": "100"
}
]
}
},
"AudioCensorResult": {
"Suggestion": "pass",
"Label": "normal"
},
"PipelineId": "c5b30b7c0d0e4a0abde1d5f9e751****"
}
]
},
"RequestId": "D1D5C080-8E2F-5030-8AB4-13092F17631B",
"NextPageToken": "9b1a42bc6e8d46e6a1383b7e7f01****",
"NonExistIds": {
"String": [
"78dc866518b843259669df58ed30****"
]
}
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2023-12-07 | OpenAPI 返回结构发生变更 | 查看变更详情 |