全部产品
Search
文档中心

媒体处理:QueryMediaCensorJobDetail - 查询媒体审核作业详情

更新时间:Nov 11, 2024

查询媒体审核作业的详细信息。

接口说明

媒体审核结果中视频部分是按照时间点从小到大排序组成一个时间线,如果视频时间非常长,查询时按分页返回第 1 页信息,如果需要详细查询视频部分的全量结果,可单独调用本接口。

QPS 限制

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

调试

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

授权信息

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

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

请求参数

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

媒体审核作业 ID。可以从提交媒体审核作业的返回参数中获取。

2288c6ca184c0e47098a5b665e2a12****
NextPageTokenstring

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

ae0fd49c0840e14daf0d66a75b83****
MaximumPageSizelong

每页最大返回数。

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

返回参数

名称类型描述示例值
object

返回参数。

RequestIdstring

请求 ID。

B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA
MediaCensorJobDetailobject

媒体审核作业结果列表。

CreationTimestring

创建时间。

2018-09-13T16:32:24Z
FinishTimestring

完成时间。

2018-09-21
Suggestionstring

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

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

任何一种类型的审核结果是 review 时,整体结果为 review,任何一种类型的审核结果是 block 时,整体结果为 block 。

block
CoverImageCensorResultsarray<object>

封面审核结果。

CoverImageCensorResultobject

返回参数。

Objectstring

视频封面 OSS Object。

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

视频封面 OSS Location。

oss-cn-shanghai
Bucketstring

视频封面 OSS Bucket。

bucket-out-test-****
Resultsarray<object>

审核结果。

Resultobject

返回参数。

Suggestionstring

处理建议。取值:

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

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

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

    • normal:正常。
    • sexy:性感。
    • porn:色情。
  • 图片暴恐涉政(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。
porn
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:拦截
review
Labelstring

审核结果分类。取值:

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

媒体审核作业 ID。

f8f166eea7a44e9bb0a4aecf9543****
UserDatastring

用户自定义数据。

example userdata ****
Codestring

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

InvalidParameter.ResourceNotFound
VensorCensorResultobject

视频审核结果。

VideoTimelinesarray<object>

详细时间点的审核结果,按照时间从小到大排序。由于详细时间点内容较多,查询仅保留 10 天,超过则自行查看保存在 OutputFile 相同的文件夹下,命名为{jobId}.output 文件。

VideoTimelineobject

返回参数。

Timestampstring

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

00:02:59.999
Objectstring

截图输出文件 (OSS Object)。

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

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

CensorResultobject

返回参数。

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:含商标。
porn,ad
Scenestring

审核场景。

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

分值。

99.99
NextPageTokenstring

下一页标识。

ea04afcca7cd4e80b9ece8fbb251****
CensorResultsarray<object>

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

CensorResultobject

审核结果详情。

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
AudioDetailResultListarray<object>

音频审核具体结果。

AudioDetailResultobject

结果内容。

StartTimeinteger

句子开始的时间,单位:秒。

0
EndTimeinteger

句子结束的时间,单位:秒。

30
Textstring

语音转换成文本的结果。

测试一下
Labelstring

检测结果的分类。取值:

  • normal:正常文本

  • spam:含垃圾信息

  • ad:广告

  • politics:涉政

  • terrorism:暴恐

  • abuse:辱骂

  • porn:色情

  • flood:灌水

  • contraband:违禁

  • meaningless:无意义

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

normal
PipelineIdstring

管道 ID。

c5b30b7c0d0e4a0abde1d5f9e751****

示例

正常返回示例

JSON格式

{
  "RequestId": "B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA",
  "MediaCensorJobDetail": {
    "CreationTime": "2018-09-13T16:32:24Z",
    "FinishTime": "2018-09-21",
    "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": "porn",
                "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": "normal",
      "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": "porn,ad",
                  "Scene": "porn",
                  "Rate": "99.99"
                }
              ]
            }
          }
        ]
      },
      "NextPageToken": "ea04afcca7cd4e80b9ece8fbb251****",
      "CensorResults": {
        "CensorResult": [
          {
            "Suggestion": "review",
            "Label": "meaningless",
            "Scene": "terrorism",
            "Rate": "100"
          }
        ]
      }
    },
    "AudioCensorResult": {
      "Suggestion": "pass",
      "Label": "normal",
      "AudioDetailResultList": {
        "AudioDetailResult": [
          {
            "StartTime": 0,
            "EndTime": 30,
            "Text": "测试一下",
            "Label": "normal"
          }
        ]
      }
    },
    "PipelineId": "c5b30b7c0d0e4a0abde1d5f9e751****"
  }
}

错误码

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

变更历史

变更时间变更内容概要操作
2023-12-07OpenAPI 返回结构发生变更查看变更详情