内容审核 Moderation内容审核 Moderation

计算
弹性云服务器 ECS
裸金属服务器 BMS
弹性伸缩 AS
镜像服务 IMS
专属主机 DeH
函数工作流 FunctionGraph
网络
虚拟私有云 VPC
弹性公网IP EIP
虚拟专用网络 VPN
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
云解析服务 DNS
VPC终端节点 VPCEP
云连接 CC
企业交换机 ESW
安全与合规
Anti-DDoS 流量清洗
Web应用防火墙 WAF
企业主机安全 HSS
数据加密服务 DEW
数据库安全服务 DBSS
DDoS高防 AAD
数据安全中心 DSC
容器安全服务 CGS
态势感知 SA
威胁检测服务 MTD
安全治理云图 Compass
云证书管理服务 CCM
DDoS防护 ADS
数据库
云数据库 RDS
文档数据库服务 DDS
数据管理服务 DAS
数据复制服务 DRS
云数据库GaussDB NoSQL
云数据库 GaussDB(for MySQL)
分布式数据库中间件 DDM
云数据库 GaussDB(for openGauss)
人工智能
MapReduce服务 MRS
数据仓库服务 GaussDB(DWS)
人脸识别服务 FRS
图引擎服务 GES
数据湖探索 DLI
云搜索服务 CSS
图像识别 Image
内容审核 Moderation
文字识别 OCR
数据湖工厂 DLF
AI开发平台ModelArts
数据接入服务 DIS
图像搜索 ImageSearch
对话机器人服务 CBS
语音交互服务 SIS
华为HiLens
数据可视化 DLV
数据湖治理中心 DGC
自然语言处理 NLP
开发与运维
软件开发平台 DevCloud
项目管理 ProjectMan
代码托管 CodeHub
部署 CloudDeploy
编译构建 CloudBuild
流水线 CloudPipeline
发布 CloudRelease
专属云
专属计算集群 DCC
专属分布式存储服务 DSS
视频
视频直播 Live
媒体处理 MPC
云生态
合作伙伴中心
用户服务
帐号中心
费用中心
成本中心
资源中心
企业管理
工单管理
国际站常见问题
备案中心
支持计划
客户运营能力
合作伙伴支持计划
专业服务
开发者工具
SDK开发指南
API签名指南
Terraform
HCloud CLI
更新时间:2022-03-24 GMT+08:00

图像内容审核

功能介绍

分析并识别用户上传的图像内容是否有敏感内容(如涉及涉黄内容等),并将识别结果返回给用户。

URI

POST /v2/{project_id}/moderation/image

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

用户的project_id

登陆华为云 -> 用户中心 -> 我的凭证 -> api凭证 即可查看对应区域的项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

url

String

与image二选一

图片的URL路径,目前支持:

  • 公网HTTP/HTTPS URL
  • 华为云OBS提供的URL,使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详请参见配置OBS访问权限
说明:

接口响应时间依赖图片的下载时间,如果图片下载时间过长,会返回接口调用失败。请保证被检测图片所在的存储服务稳定可靠,建议您使用华为云OBS存储。

image

String

与url二选一

图片文件Base64编码字符串。要求base64编码后大小不超过10M。

支持JPG/PNG/BMP格式。

moderation_rule

String

图像审核规则名称,默认使用default规则。

说明:

审核规则的创建和使用请参见配置审核规则

categories

Array of strings

检测场景:

  • porn:是否包含涉黄内容元素的检测。
  • ad:是否包含广告图文的检测。
  • all:包含全部场景的检测。

可通过配置上述场景,来完对应场景元素的检测。

说明:

每个检测场景的检测次数会分类统计。

枚举值:

  • porn
  • ad

ad_glossaries

Array of strings

检测场景: ad场景自定义词库,配置方式同文本审核自定义词库配置方式

ad_categories

Array of strings

图文审核检测场景。当categories包含ad时,该参数生效。

当前支持的场景有系统场景和用户自定义场景:
  • 系统场景为:
    • qr_code:二维码
    • porn:涉黄
    • ad:广告
    • abuse:辱骂
    • contraband:违禁品
  • 用户自定义场景为:自定义黑名单词库。
    说明:

    自定义词库的创建和使用请参见配置自定义词库

threshold

Float

结果过滤门限,只有置信度不低于此门限的结果才会呈现在detail的列表中,取值范围 0-1,当未设置此值时各个检测场景会使用各自的默认值。

ad检测场景的默认值为0。

无特殊需求直接不传此参数或像示例中一样值设为空字符串即可。

说明:
  • 如果检测场景中的最高置信度也未达到threshold,则结果列表为空;反之threshold过小,则会使结果列表中内容过多。
  • threshold参数不支持porn场景筛选。
  • threshold参数不会对响应中的suggestion产生影响。

最小值:0

最大值:1

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

result

ImageDetectionResultBody object

调用成功时表示调用结果。

调用失败时无此字段。

表5 ImageDetectionResultBody

参数

参数类型

描述

detail

ImageDetectionResultDetail object

针对选定的每个检测场景列出结果列表,porn为涉黄检测结果。如果检测场景中的最高置信度也未达到threshold则结果列表为空。

suggestion

String

审核结果是否通过。

block:包含敏感信息,不通过

pass:不包含敏感信息,通过

review:需要人工复检

说明:
  1. 当同时检测多个场景时,suggestion的值以最可能包含敏感信息的场景为准。即任一场景出现了block则总的suggestion为block,所有场景都pass时suggestion为pass,这两种情况之外则一定有场景需要review,此时suggestion为review。
  2. 目前本服务不会保存客户的调用结果(如block的历史信息),因为涉及到客户的数据隐私问题,建议您在业务上做一下接口调用结果日志信息的保留。

category_suggestions

Map<String,String>

具体每个场景的检测结果。目前本服务不会保存客户的调用结果。

block:包含敏感信息,不通过

pass:不包含敏感信息,通过

review:需要人工复检

表6 ImageDetectionResultDetail

参数

参数类型

描述

porn

Array of ImageDetectionResultSimpleDetail objects

涉黄检测结果。

ad

Array of ImageDetectionResultAdDetail objects

广告检测结果。

表7 ImageDetectionResultSimpleDetail

参数

参数类型

描述

confidence

Float

置信度,取值范围 0-1。

label

String

每个检测结果的标签化说明:

porn:label为对应的涉黄分类(涉黄、性感等)信息。

  • 鉴黄场景当前支持label列表如下:
    • normal:正常
    • porn:色情
    • sexy:性感

ad:label为对应的广告识别结果信息。

  • 广告场景当前支持label列表如下:
    • normal:正常
    • ad:广告
  • 图文审核场景当前支持label列表如下:
    • normal:正常
    • qr_code:二维码
    • porn:涉黄
    • ad:广告
    • abuse:辱骂
    • contraband:违禁品
    • 其他自定义黑库名称
表8 ImageDetectionResultAdDetail

参数

参数类型

描述

confidence

Float

置信度,取值范围 0-1。

label

String

ad:label为对应的广告识别结果信息

  • 广告场景当前支持label列表如下:
    • normal:正常
    • ad:广告
  • 图文审核场景当前支持label列表如下:
    • normal:正常
    • qr_code:二维码
    • porn:涉黄
    • ad:广告
    • abuse:辱骂
    • contraband:违禁品
    • 其他自定义黑库名称

hit_contexts

Array of strings

图文审核场景命中的文本列表。

状态码: 400

表9 响应Body参数

参数

参数类型

描述

error_code

String

调用失败时的错误码,具体请参见错误码

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

fail_category

String

当包含多个场景时,失败场景

请求示例

  • 方式一:使用图片的BASE64编码
    POST https://{endpoint}/v2/{project_id}/moderation/image
    
    {
      "categories" : [ "politics", "terrorism" ],
      "moderation_rule" : "default",
      "url" : "",
      "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAA...",
      "threshold" : ""
    }
  • 方式二:使用图片的url
    POST https://{endpoint}/v2/{project_id}/moderation/image
    
    {
      "categories" : [ "politics", "terrorism" ],
      "moderation_rule" : "default",
      "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName",
      "image" : "",
      "threshold" : ""
    }

响应示例

状态码: 200

成功响应示例

{
  "result" : {
    "detail" : {
      "politics" : [ {
        "confidence" : 0.8915528178215026,
        "face_detail" : {
          "h" : 130,
          "w" : 103,
          "x" : 80,
          "y" : 109
        },
        "label" : "xxx"
      }, {
        "confidence" : 0.8756346243265443,
        "face_detail" : {
          "h" : 131,
          "w" : 203,
          "x" : 423,
          "y" : 109
        },
        "label" : "yyy"
      } ],
      "terrorism" : [ {
        "confidence" : 0.7315528178215026,
        "label" : "xxx"
      }, {
        "confidence" : 0.26844718217849733,
        "label" : "yyy"
      } ]
    },
    "suggestion" : "block",
    "category_suggestions" : {
      "politics" : "block",
      "terrorism" : "review"
    }
  }
}

状态码: 400

失败响应示例

{
  "error_code" : "AIS.0402",
  "error_msg" : "The image format is not supported."
}

状态码

状态码

描述

200

成功响应示例。

400

失败响应示例。

错误码

请参见错误码

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

在文档使用中是否遇到以下问题







请至少选择或填写一项反馈信息

字符长度不能超过200

反馈内容不能为空!

提交反馈 取消