通过QueryMediaCensorJobList接口查询媒体审核作业列表-媒体处理-阿里云

查询媒体审核作业列表。

接口说明

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

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	integer	否	每页最大返回数。默认：30 取值：1~300	20
State	string	否	需要查询的作业状态。取值： All：全部。 Queuing：排队中。 Analysing：分析中。 Fail：失败。 Success：成功。	All
StartOfJobCreatedTimeRange	string	否	最早任务创建时间。日期格式按照 ISO8601 标准表示，并需要使用 UTC 时间。格式为：YYYY-MM-DDThh:mm:ssZ 。	2021-12-22T03:48:05Z
EndOfJobCreatedTimeRange	string	否	最晚任务创建时间。日期格式按照 ISO8601 标准表示，并需要使用 UTC 时间。格式为：YYYY-MM-DDThh:mm:ssZ 。	2022-02-14T02:16:07Z
PipelineId	string	否	管道 ID。可以通过媒体处理控制台 > 全局设置 > 管道及回调获取。	c5b30b7c0d0e4a0abde1d5f9e751****

返回参数

名称	类型	描述	示例值
	object	返回参数。
MediaCensorJobList	object
MediaCensorJob	array<object>	媒体审核作业列表。
	array<object>	媒体审核作业详细信息。
CreationTime	string	任务创建时间。	2021-11-04T07:25:48Z
FinishTime	string	完成时间。	2021-11-04T07:25:48Z
Suggestion	string	处理建议。可取值： pass：通过。 review：人工重审。 block：拦截。	pass
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。	example-Bucket-****
Results	object
Result	array<object>	作业审核结果。
	object	作业审核结果详细信息。
Suggestion	string	作业整体审核结果。取值： pass：通过。 review：人工重审。 block：拦截。说明任何一种类型的审核结果是 Review 时，整体结果为 Review，任何一种类型的审核结果是 Block 时，整体结果为 Block。	pass
Label	string	审核结果的标签，多个使用半角逗号（,）分隔。图片智能鉴黄（porn）审核结果分类： nomal：正常。 sexy：性感。 porn：色情。图片暴恐涉政（terrorism）结果分类： naomal：正常。 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：含商标。	normal
Scene	string	审核场景。 porn：鉴黄。 terrorism：暴恐涉政。 ad：图文违规。 live：不良场景。 Logo：图片 Logo。	live
Rate	string	分值。可取值：0~100。	100
State	string	作业状态。	Success
TitleCensorResult	object	标题审核结果。
Suggestion	string	处理建议。取值： pass：通过。 review：人工重审。 block：拦截。	block
Label	string	审核结果的标签，多个使用半角逗号（,）分隔。 normal：普通 spam：含垃圾信息 ad：广告 politics：涉政 terrorism：暴恐 abuse：辱骂 porn：色情 flood：灌水 contraband：违禁 meaningless：无意义 harmful：不良场景（支持拜金炫富、追星应援、负面情绪、负面诱导等检测场景）	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：通过。 review：人工重审。 block：拦截。	pass
Label	string	审核结果分类，多个使用半角逗号（,）分隔。取值： normal：普通 spam：含垃圾信息 ad：广告 politics：涉政 terrorism：暴恐 abuse：辱骂 porn：色情 flood：灌水 contraband：违禁 meaningless：无意义 harmful：不良场景（支持拜金炫富、追星应援、负面情绪、负面诱导等检测场景）	normal
Scene	string	审核场景。固定取值：antispam，文本反垃圾。	antispam
Rate	string	分值。	99.91
DescCensorResult	object	描述审核结果。
Suggestion	string	处理建议。可取值： pass：通过。 review：人工重审。 block：拦截。	pass
Label	string	审核结果分类，多个使用半角逗号（,）分隔。取值： normal：普通 spam：含垃圾信息 ad：广告 politics：涉政 terrorism：暴恐 abuse：辱骂 porn：色情 flood：灌水 contraband：违禁 meaningless：无意义 harmful：不良场景（支持拜金炫富、追星应援、负面情绪、负面诱导等检测场景）	ad
Scene	string	审核场景。固定取值：antispam，文本反垃圾。	antispam
Rate	string	分值。	100
VideoCensorConfig	object	视频审查配置。
OutputFile	object	视频截图结果的保存地址。
Object	string	截图输出文件（OSS Object）。说明示例中{Count}是占位符，图片 Object 依次为`output00001-**.jpg,output00002-**.jpg`等。	output{Count}.jpg
Location	string	截图输出 OSS Bucket 所在的 OSS Location。	oss-cn-shanghai
Bucket	string	截图输出文件所在 OSS Bucket。	test-bucket-****
VideoCensor	string	是否需要审核视频内容。默认值：true。可取值： true：审核。 false：不审核。	true
BizType	string	审核模板。默认 common（默认模板）。说明不填默认为 common，如果是通过提交工单自定义的审核模板，此项返回 UID。	common
JobId	string	媒体审核作业 ID。	f8f166eea7a44e9bb0a4aecf9543****
UserData	string	用户自定义数据。	example userdata ****
Code	string	作业失败时错误码。执行成功时此参数不返回。	InvalidParameter.ResourceNotFound
VensorCensorResult	object	视频审查结果。
VideoTimelines	object
VideoTimeline	array<object>	详细时间点的审核结果，按照时间从小到大排序。
	array<object>	详细信息。
Timestamp	string	视频中的位置。格式：`hh:mm:ss[.SSS]`。	00:02:59.999
Object	string	截图输出文件（OSS Object）。说明示例中{Count}是占位符，图片 Object 依次为`output00001-**.jpg,output00002-**.jpg`等。	output{Count}.jpg
CensorResults	object
CensorResult	array<object>	包含多种类型审核结果的标签、分值等。
	object	详细信息。
Suggestion	string	处理建议。取值： pass：通过， review：人工重审， block：拦截。	block
Label	string	审核结果分类，多个使用半角逗号（,）分隔。取值：图片鉴黄（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：含商标。	normal
Scene	string	审核场景。 porn：鉴黄。 terrorism：暴恐涉政。 ad：图文违规。 live：不良场景。 logo：图片 Logo。	pron
Rate	string	分值。	99.99
NextPageToken	string	下一页标识。	ea04afcca7cd4e80b9ece8fbb251****
CensorResults	object
CensorResult	array<object>	审核结果集合，包含各种场景（黄、暴、恐、政）的概要信息。
	object	审核结果详细信息。
Suggestion	string	处理建议。取值： pass：通过。 review：人工重审。 block：拦截。	review
Label	string	审核结果分类，多个使用半角逗号（,）分隔。取值：图片鉴黄（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：含商标。	meaningless
Scene	string	审核场景。 porn：鉴黄。 terrorism：暴恐涉政。 ad：图文违规。 live：不良场景。 logo：图片 Logo。	terrorism
Rate	string	分值。	100
AudioCensorResult	object	音频审核结果。
Suggestion	string	处理建议。可取值： pass：通过 review：人工重审 block：拦截	pass
Label	string	检测结果的分类。取值： normal：正常文本 spam：含垃圾信息 ad：广告 politics：涉政 terrorism：暴恐 abuse：辱骂 porn：色情 flood：灌水 contraband：违禁 meaningless：无意义 harmful：不良场景（支持拜金炫富、追星应援、负面情绪、负面诱导等检测场景）	normal
PipelineId	string	管道 ID。	c5b30b7c0d0e4a0abde1d5f9e751****
RequestId	string	请求 ID。	D1D5C080-8E2F-5030-8AB4-13092F17631B
NextPageToken	string	下一页标识，32 位 UUID。查询结果大于一页时返回，每次查询值都会更新。	9b1a42bc6e8d46e6a1383b7e7f01****
NonExistIds	object
String	array	不存在的作业 ID 列表。如果为空则不返回此参数。
	string	作业 ID。	78dc866518b843259669df58ed30****

示例

正常返回示例

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****"
    ]
  }
}

错误码

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

变更历史

更多信息，参考变更详情。