文档

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

更新时间:

查询媒体审核作业列表。

接口说明

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

QPS 限制

本接口的单用户 QPS 限制为 100 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见 QPS 限制

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

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

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

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

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

79aff3eee82242e092899db5f669****
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

返回参数。

MediaCensorJobListobject []

媒体审核作业列表。

CreationTimestring

任务创建时间。

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

完成时间。

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

处理建议。可取值:

  • pass:通过。
  • review:人工重审。
  • block:拦截。
pass
CoverImageCensorResultsobject []

封面图片审查结果列表。

Objectstring

封面图片的 OSS Object。

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

封面图片的 OSS Location。

oss-cn-shanghai
Bucketstring

封面图片的 OSS Bucket。

example-Bucket-****
Resultsobject []

作业审核结果。

Suggestionstring

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

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

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

  • 图片智能鉴黄(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
Scenestring

审核场景。

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

分值。可取值:0~100。

100
Statestring

作业状态。

Success
TitleCensorResultobject

标题审核结果。

Suggestionstring

处理建议。取值:

  • pass:通过。

  • review:人工重审。

  • block:拦截。

block
Labelstring

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

  • normal:普通
  • spam:含垃圾信息
  • ad:广告
  • politics:涉政
  • terrorism:暴恐
  • abuse:辱骂
  • porn:色情
  • flood:灌水
  • contraband:违禁
  • meaningless:无意义
  • harmful:不良场景(支持拜金炫富、追星应援、负面情绪、负面诱导等检测场景)
meaningless
Scenestring

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

antispam
Ratestring

分值。

99.91
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:广告
  • politics:涉政
  • terrorism:暴恐
  • abuse:辱骂
  • porn:色情
  • flood:灌水
  • contraband:违禁
  • meaningless:无意义
  • harmful:不良场景(支持拜金炫富、追星应援、负面情绪、负面诱导等检测场景)
normal
Scenestring

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

antispam
Ratestring

分值。

99.91
DescCensorResultobject

描述审核结果。

Suggestionstring

处理建议。可取值:

  • pass:通过。

  • review:人工重审。

  • block:拦截。

pass
Labelstring

审核结果分类,多个使用半角逗号(,)分隔。取值:

  • normal:普通
  • spam:含垃圾信息
  • ad:广告
  • politics:涉政
  • terrorism:暴恐
  • abuse:辱骂
  • porn:色情
  • flood:灌水
  • contraband:违禁
  • meaningless:无意义
  • harmful:不良场景(支持拜金炫富、追星应援、负面情绪、负面诱导等检测场景)
ad
Scenestring

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

antispam
Ratestring

分值。

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

视频审查结果。

VideoTimelinesobject []

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

Timestampstring

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

00:02:59.999
Objectstring

截图输出文件(OSS Object)。

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

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

Suggestionstring

处理建议。取值:

  • pass:通过,

  • review:人工重审,

  • block:拦截。

block
Labelstring

审核结果分类,多个使用半角逗号(,)分隔。取值:

  • 图片鉴黄(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
Scenestring

审核场景。

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

分值。

99.99
NextPageTokenstring

下一页标识。

ea04afcca7cd4e80b9ece8fbb251****
CensorResultsobject []

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

Suggestionstring

处理建议。取值:

  • pass:通过。

  • review:人工重审。

  • block:拦截。

review
Labelstring

审核结果分类,多个使用半角逗号(,)分隔。取值:

  • 图片鉴黄(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
Scenestring

审核场景。

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

分值。

100
AudioCensorResultobject

音频审核结果。

Suggestionstring

处理建议。可取值:

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

检测结果的分类。取值:

  • normal:正常文本

  • spam:含垃圾信息

  • ad:广告

  • politics:涉政

  • terrorism:暴恐

  • abuse:辱骂

  • porn:色情

  • flood:灌水

  • contraband:违禁

  • meaningless:无意义

  • harmful:不良场景(支持拜金炫富、追星应援、负面情绪、负面诱导等检测场景)

normal
PipelineIdstring

管道 ID。

c5b30b7c0d0e4a0abde1d5f9e751****
RequestIdstring

请求 ID。

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

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

9b1a42bc6e8d46e6a1383b7e7f01****
NonExistIdsarray

不存在的作业 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****"
    ]
  }
}

错误码

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

变更历史

变更时间变更内容概要操作
2023-12-07OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更
  • 本页导读 (1)
文档反馈