QueryMediaCensorJobList - 查询媒体审核作业列表

调用QueryMediaCensorJobList查询媒体审核作业列表。

接口说明

本接口只支持查询三个月内的媒体审核作业列表。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ice:QueryMediaCensorJobListget
*全部资源
*

请求参数

名称类型必填描述示例值
JobIdsstring

媒体审核作业 ID。可以从提交媒体审核作业的返回参数中获取,多个使用半角逗号(,)分隔。

fa9c34be3bcf42919ac4d1775239****,78dc866518b843259669df58ed30****
NextPageTokenstring

下一页标识,第一次提交时为空即可。下一页标识将在第一次查询后返回。

79aff3eee82242e092899db5****
MaximumPageSizelong

每页最大返回数。

  • 默认:30
  • 取值:1~300
20
Statestring

需要查询的作业状态。取值:

  • All:全部。

  • Queuing:排队中。

  • Analysing:分析中。

  • Fail:失败。

  • Success:成功。

All
StartOfJobCreatedTimeRangestring

最早任务创建时间。

  • 日期格式按照 ISO8601 标准表示,并需要使用 UTC 时间。
  • 格式为:YYYY-MM-DDThh:mm:ssZ 。
2021-12-22T03:48:05Z
EndOfJobCreatedTimeRangestring

最晚任务创建时间。

  • 日期格式按照 ISO8601 标准表示,并需要使用 UTC 时间。
  • 格式为:YYYY-MM-DDThh:mm:ssZ 。
2022-02-14T02:16:07Z
PipelineIdstring

管道 ID。

c5b30b7c0d0e4a0abde1d5f9e751****

返回参数

名称类型描述示例值
object

返回参数。

MediaCensorJobListarray<object>

媒体审核作业列表。

MediaCensorJobobject

媒体审核作业详细信息。

CreationTimestring

任务创建时间。

2021-11-04T07:25:48Z
FinishTimestring

完成时间。

2021-11-04T07:25:50Z
Suggestionstring

处理建议。可取值:

  • pass:通过
  • review:人工重审
  • block:拦截
pass
CoverImageCensorResultsarray<object>

封面图片审查结果列表。

CoverImageCensorResultobject

封面图片审查结果详细信息。

Objectstring

封面图片的 OSS Object。

test/ai/censor/v2/vme-****.jpg
Locationstring

封面图片的 OSS Object。

oss-cn-shanghai
Bucketstring

封面图片的 OSS Bucket。

example-Bucket-****
Resultsarray<object>

作业审核结果。

Resultobject

作业审核结果详细信息。

Suggestionstring

作业整体审核结果。取值:

  • pass:通过。
  • review:人工重审。
  • block:拦截。
说明 任何一种类型的审核结果是 review 时,整体结果为 review,任何一种类型的审核结果是 block 时,整体结果为 block。
pass
Labelstring

审核结果的标签,多个使用半角逗号(,)分隔。

  • 图片智能鉴黄(porn)审核结果分类:

    • nomal:正常。
    • sexy:性感。
    • porn:色情。
  • 图片暴恐涉政(terrorism)结果分类:

    • naomal:正常。
    • bloody:血腥。
    • explosion:爆炸烟光。
    • outfit:特殊装束。
    • logo:特殊标识。
    • weapon:武器。
    • polotocs:涉政。
    • 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:含商标。
normal
Scenestring

审核场景。

  • porn:鉴黄
  • terrorism:暴恐涉政
  • ad:图文违规
  • live:不良场景
  • logo:图片 logo
live
Ratestring

分值。可取值:0~100。

100
Statestring

作业状态。

Success
TitleCensorResultobject

标题审核结果。

Suggestionstring

处理建议。取值:

  • pass:通过
  • review:人工重审
  • block:拦截
block
Labelstring

审核结果的标签,多个使用半角逗号(,)分隔。

  • normal:普通
  • spam:含垃圾信息
  • ad:广告
  • abuse:辱骂
  • flood:灌水
  • contraband:违禁
  • meaningless:无意义
meaningless
Scenestring

审核场景。取固定值:antispam,文本反垃圾。

antispam
Ratestring

分值。可取值:0~100。

100
Messagestring

作业失败时错误信息。执行成功时不返回此参数。

The resource operated cannot be found
Inputobject

作业输入。

Objectstring

输入文件的 OSS Object。

test/ai/censor/test-****.mp4
Locationstring

输入文件的 OSS Location。

oss-cn-shanghai
Bucketstring

输入文件的 OSS Bucket。

bucket-test-in-****
BarrageCensorResultobject

弹幕审核结果。

Suggestionstring

处理建议。取值:

  • pass:通过
  • review:人工重审
  • block:拦截
pass
Labelstring

审核结果的标签,多个使用半角逗号(,)分隔。

  • normal:普通
  • spam:含垃圾信息
  • ad:广告
  • abuse:辱骂
  • flood:灌水
  • contraband:违禁
  • meaningless:无意义
normal
Scenestring

审核场景。取固定值:antispam,文本反垃圾。

antispam
Ratestring

分值。可取值:0~100。

99.91
DescCensorResultobject

描述审核结果。

Suggestionstring

处理建议。取值:

  • pass:通过
  • review:人工重审
  • block:拦截
pass
Labelstring

审核结果的标签,多个使用半角逗号(,)分隔。

  • normal:普通
  • spam:含垃圾信息
  • ad:广告
  • abuse:辱骂
  • flood:灌水
  • contraband:违禁
  • meaningless:无意义
normal
Scenestring

审核场景。取固定值:antispam,文本反垃圾。

antispam
Ratestring

分值。可取值:0~100。

100
VideoCensorConfigobject

视频审查配置。

OutputFileobject

视频截图结果的保存地址。

Objectstring

截图输出文件 (OSS Object)。

说明 示例中{Count}是占位符,图片 Object 依次为output00001-****.jpg,output00002-****.jpg等。
output{Count}.jpg
Locationstring

截图输出 OSS Bucket 所在的 OSS Location。

oss-cn-shanghai
Bucketstring

截图输出文件所在 OSS Bucket。

test-bucket-****
VideoCensorstring

是否需要审核视频内容。默认值:true。可取值:

  • true:审核

  • false:不审核

true
BizTypestring

审核模板。默认 common(默认模板)。

说明 不填默认为 common,如果是通过提交工单自定义的审核模板,此项返回 UID。
common
JobIdstring

媒体审核作业 ID。

f8f166eea7a44e9bb0a4aecf9543
UserDatastring

用户自定义数据。

example userdata ****
Codestring

作业失败时错误码。执行成功时此参数不返回。

InvalidParameter.ResourceNotFound
VensorCensorResultobject

视频审查结果。

VideoTimelinesarray<object>

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

VideoTimelineobject

详细信息。

Timestampstring

视频中的位置。格式:hh:mm:ss[.SSS]

00:02:59.999
Objectstring

截图输出文件 (OSS Object)。

说明 示例中{Count}是占位符,图片 Object 依次为output00001-****.jpgoutput00002-****.jpg等。
output{Count}.jpg
CensorResultsarray<object>

包含多种类型审核结果的标签、分值等。

CensorResultobject

详细信息。

Suggestionstring

处理建议。取值:

  • pass:通过
  • review:人工重审
  • block:拦截
block
Labelstring

审核结果的标签,多个使用半角逗号(,)分隔。

  • 图片智能鉴黄(porn)审核结果分类:

    • nomal:正常。
    • sexy:性感。
    • porn:色情。
  • 图片暴恐涉政(terrorism)结果分类:

    • naomal:正常。
    • bloody:血腥。
    • explosion:爆炸烟光。
    • outfit:特殊装束。
    • logo:特殊标识。
    • weapon:武器。
    • polotocs:涉政。
    • 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:含商标。
normal
Scenestring

审核场景。

  • porn:鉴黄。
  • terrorism:暴恐涉政。
  • ad:图文违规。
  • live:不良场景。
  • logo:图片 logo。
porn
Ratestring

分值。可取值:0~100。

100
NextPageTokenstring

下一页标识。

ea04afcca7cd4e80b9ece8fbb251
CensorResultsarray<object>

审核结果集合,包含各种场景(黄、暴、恐、政)的概要信息。

CensorResultobject

审核结果详细信息。

Suggestionstring

处理建议。取值:

  • pass:通过。

  • review:人工重审。

  • block:拦截。

pass
Labelstring

审核结果的标签,多个使用半角逗号(,)分隔。

  • 图片智能鉴黄(porn)审核结果分类:

    • nomal:正常。
    • sexy:性感。
    • porn:色情。
  • 图片暴恐涉政(terrorism)结果分类:

    • naomal:正常。
    • bloody:血腥。
    • explosion:爆炸烟光。
    • outfit:特殊装束。
    • logo:特殊标识。
    • weapon:武器。
    • polotocs:涉政。
    • 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:含商标。
meaningless
Scenestring

审核场景。

  • porn:鉴黄。
  • terrorism:暴恐涉政。
  • ad:图文违规。
  • live:不良场景。
  • logo:图片 Logo。
ad
Ratestring

分值。可取值:0~100。

100
PipelineIdstring

管道 ID。

c5b30b7c0d0e4a0abde1d5f9e751****
RequestIdstring

请求 ID。

D1D5C080-8E2F-5030-8AB4-13092F17631B
NextPageTokenstring

下一页标识,32 位 UUID。查询结果大于一页时返回,每次查询值都会更新。

9b1a42bc6e8d46e6a1383b7e7f01****
NonExistIdsarray

不存在的作业 ID 列表。如果为空则不返回此参数。

Stringstring

作业 ID。

78dc866518b843259669df58ed30****

示例

正常返回示例

JSON格式

{
  "MediaCensorJobList": {
    "MediaCensorJob": [
      {
        "CreationTime": "2021-11-04T07:25:48Z\n",
        "FinishTime": "2021-11-04T07:25:50Z\n",
        "Suggestion": "pass",
        "CoverImageCensorResults": {
          "CoverImageCensorResult": [
            {
              "Object": "test/ai/censor/v2/vme-****.jpg\n",
              "Location": "oss-cn-shanghai",
              "Bucket": "example-Bucket-****\n",
              "Results": {
                "Result": [
                  {
                    "Suggestion": "pass",
                    "Label": "normal",
                    "Scene": "live",
                    "Rate": "100"
                  }
                ]
              }
            }
          ]
        },
        "State": "Success",
        "TitleCensorResult": {
          "Suggestion": "block",
          "Label": "meaningless",
          "Scene": "antispam",
          "Rate": "100"
        },
        "Message": "The resource operated cannot be found",
        "Input": {
          "Object": "test/ai/censor/test-****.mp4",
          "Location": "oss-cn-shanghai\n",
          "Bucket": "bucket-test-in-****"
        },
        "BarrageCensorResult": {
          "Suggestion": "pass",
          "Label": "normal",
          "Scene": "antispam",
          "Rate": "99.91"
        },
        "DescCensorResult": {
          "Suggestion": "pass",
          "Label": "normal",
          "Scene": "antispam",
          "Rate": "100"
        },
        "VideoCensorConfig": {
          "OutputFile": {
            "Object": "output{Count}.jpg",
            "Location": "oss-cn-shanghai\n",
            "Bucket": "test-bucket-****\n"
          },
          "VideoCensor": "true",
          "BizType": "common"
        },
        "JobId": "f8f166eea7a44e9bb0a4aecf9543",
        "UserData": "example userdata ****\n",
        "Code": "InvalidParameter.ResourceNotFound",
        "VensorCensorResult": {
          "VideoTimelines": {
            "VideoTimeline": [
              {
                "Timestamp": "00:02:59.999",
                "Object": "output{Count}.jpg",
                "CensorResults": {
                  "CensorResult": [
                    {
                      "Suggestion": "block",
                      "Label": "normal",
                      "Scene": "porn",
                      "Rate": "100"
                    }
                  ]
                }
              }
            ]
          },
          "NextPageToken": "ea04afcca7cd4e80b9ece8fbb251",
          "CensorResults": {
            "CensorResult": [
              {
                "Suggestion": "pass",
                "Label": "meaningless",
                "Scene": "ad",
                "Rate": "100"
              }
            ]
          }
        },
        "PipelineId": "c5b30b7c0d0e4a0abde1d5f9e751****\n"
      }
    ]
  },
  "RequestId": "D1D5C080-8E2F-5030-8AB4-13092F17631B\n",
  "NextPageToken": "9b1a42bc6e8d46e6a1383b7e7f01****\n",
  "NonExistIds": {
    "String": [
      "78dc866518b843259669df58ed30****\n"
    ]
  }
}

错误码

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