内容审核 MODERATION-图像内容审核(V2):请求参数

时间:2024-08-05 10:12:11

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

用于获取操作API的权限。获取方法请参见 获取Token 接口,响应消息头中X-Subject-Token的值即为Token。

表3 请求Body参数

参数

是否必选

参数类型

描述

url

String

与image二选一。

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

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

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

image

String

与url二选一。

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

支持JPEG/PNG/BMP/WEBP/GIF格式。

moderation_rule

String

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

说明:

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

categories

Array of strings

检测场景。可添加的检测场景如下:

  • terrorism:暴恐元素的检测。
  • porn:涉黄内容元素的检测。
  • ad:广告图文的检测。
  • all:terrorism和porn等场景的检测,当选择all时,无法再添加其他场景,否则会报错。

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

为空或无此参数表示terrorism检测,但不包含porn场景。

说明:

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

ad_categories

Array of strings

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

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

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

threshold

Float

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

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

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

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

show_ocr_text

Boolean

是否返回ocr识别结果,默认值为false。

support.huaweicloud.com/api-moderation/moderation_03_0019.html