内容审核 Moderation-文本内容审核(V2):请求参数

时间:2023-11-01 16:19:13

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

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

表3 请求Body参数

参数

是否必选

参数类型

描述

categories

Array of strings

检测场景。

当前支持的场景有默认场景和用户自定义场景:

  • 默认场景为:
    • porn:涉黄
    • ad:广告
    • abuse:辱骂
    • contraband:违禁品
    • flood:灌水 (单个或多个数字/字符/标点符号大量重复出现在文本中,将被识别为灌水)
  • 用户自定义场景为:自定义黑名单词库。
    说明:
    • 默认场景采用人工智能文本检测技术识别您所上传的文本内容,自定义场景可通过您自行配置黑名单词库来过滤和检测指定文本内容。
    • 自定义黑名单词库的名称指定给categories就是设置自定义的场景,自定义词库的创建和使用请参见配置自定义词库
    • flood场景不支持使用自定义白名单词库。

white_glossaries

Array of strings

启用的白名单列表。不配置该参数,默认使用2022-09-02 16:00:00之前创建的白名单词库。

配置该参数,有如下规则:
  • 当参数为空列表(即为[ ])时,表示不使用白名单词库。
  • 当参数设置为您创建的白名单词库名称时,表示启用该词库。
    说明:

    如果您有多个白名单词库想要同时使用,例如有三个白名单词库分别为A,B,C。该参数应设置为["A", "B", "C"] 。

白名单词库的创建和使用请参见创建自定义白名单词库

items

Array of TextDetectionItemsReq objects

待检测的文本列表,目前暂时每次只支持传一个item。

表4 TextDetectionItemsReq

参数

是否必选

参数类型

描述

text

String

待检测文本。编码格式为“utf-8”,限定1-5000个字符,文本长度超过5000个字符时,只检测前5000个字符。

type

String

文本类型。默认为“content”,即正文内容,当前只支持“content”类型,未来会扩大支持类型范围。

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