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

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

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

Enterprise-Project-Id

String

企业项目ID。Moderation支持通过企业项目管理(EPS)对不同用户组和用户的资源使用,进行分账。 获取方法:进入“企业项目管理”页面,单击企业项目名称,在企业项目详情页获取Enterprise-Project-Id(企业项目ID)。 企业项目创建步骤请参见用户指南。

说明: 创建企业项目后,在传参时,有以下三类场景:

  • 携带正确的ID,正常使用Moderation服务,账单的企业项目会被分类到企业ID对应的企业项目中。
  • 携带格式正确但不存在的ID,正常使用Moderation服务,账单的企业项目会显示对应不存在的企业项目ID。
  • 不携带ID或格式错误ID(包含特殊字符等),正常使用Moderation服务,账单的企业项目会被分类到"default"中。
表3 请求Body参数

参数

是否必选

参数类型

描述

event_type

String

事件类型。 可选值如下:

  • head_image:头像
  • album:相册
  • dynamic:动态
  • article:帖子
  • comment:评论
  • room_cover:房间封面
  • group_message:群聊图片
  • message:私聊图片
  • product:商品图片
说明:
  • 群聊图片是指多人聊天的图片。
  • 事件类型是服务提前预置的业务场景(部分场景下存在未拦截情况)。
    1. 如果您需要开启自定义审核策略,可以通过在控制台上自行添加自定义策略。
    2. 如果您有特殊的审核需求,如果工单的方式联系我们进行调整。

categories

Array of strings

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

  • terrorism:暴恐元素的检测。
  • porn:涉黄元素的检测。
  • image_text:广告图文的检测。

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

说明:

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

image_text_config

ImgTextConfig object

图文审核黑白词库配置。

url

String

与image二选一。

图片url,目前支持:公网HTTP/HTTPS URL。

image

String

与url二选一。

图片文件Base64编码字符串,要求base64编码后大小不超过10M,图片宽高不低于20 x 20像素,支持JPG/PNG/JPEG/WEBP/GIF/TIFF/TIF/HEIF等格式。

language

String

可指定图片中的文字语种,目前支持中文(zh)。默认值为zh。

biz_type

String

用户在控制台界面创建的自定义审核策略名称,具体创建步骤请参见策略管理

  • 如果请求参数中传了biz_type则优先使用biz_type,event_type和categories参数将不生效,审核策略由biz_type的设置决定。
  • 如果用户没传biz_type则event_type和categories必须传。
表4 ImgTextConfig

参数

是否必选

参数类型

描述

black_glossary_names

Array of strings

检测时使用的自定义黑名单词库列表。

详情请看配置自定义词库 V3

white_glossary_names

Array of strings

检测时使用的自定义白名单词库列表。

详情请看配置自定义词库 V3

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