4.1.1 文本内容审核
功能介绍
分析并识别用户上传的文本内容是否有敏感内容（如色情、政治等），并将识别结果 返回给用户。
前提条件
● 在使用文本内容审核之前需要您完成服务申请和认证鉴权，具体操作流程请参见
内容审核快速入门。
● 文本内容审核默认API调用最大并发为50，如需调整更高并发限制请联系华为专业 工程师为您服务。
● 您可以配置自定义词库，来过滤和检测指定文本内容。自定义词库的创建和使用 请参见配置自定义词库。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/{project_id}/moderation/text
表4-1 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 用户的project_id
登陆华为云 -> 用户中心 -> 我的凭证 ->
请求参数
表4-2 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户Token接口获 取（响应消息头中X-Subject-Token的 值）。
表4-3 请求 Body 参数
参数 是否必选 参数类型 描述
categorie
s 否 Array of
strings 检测场景。
当前支持的场景有默认场景和用户自定 义场景：
● 默认场景为：
– politics：涉政 – porn：涉黄 – ad：广告 – abuse：辱骂
– contraband：违禁品 – flood：灌水
● 用户自定义场景为：自定义黑名单词 库。
说明
● 自定义黑名单词库的名称指定给 categories就是设置自定义的场景，自 定义词库的创建和使用请参见配置自 定义词库。
● flood场景不支持使用自定义白名单词 库。
items 是 Array of TextDetecti onItemsRe q objects
待检测的文本列表，目前暂时每次只支 持传一个item。
表4-4 TextDetectionItemsReq
参数 是否必选 参数类型 描述
text 是 String 待检测文本，编码格式为“utf-8”，限 定5000个字符以内，文本长度超过5000 个字符时，只检测前5000个字符。
最小长度：1 最大长度：5000
type 否 String 文本类型，默认为“content”，即正文 内容，当前只支持“content”类型，未 来会扩大支持类型范围。
响应参数
状态码： 200
表4-5 响应 Body 参数
参数 参数类型 描述
result result object 调用成功时表示调用结果。
调用失败时无此字段。
表4-6 result
参数 参数类型 描述
suggestio
n String 检测结果是否通过。
block：包含敏感信息，不通过。
pass：不包含敏感信息，通过。
review：需要人工复查。
detail Object 返回的相关检测结果详细信息：
● politics：涉政敏感词列表。
● porn：涉黄敏感词列表。
● ad：广告敏感词列表。
● abuse：辱骂敏感词列表。
● contraband：违禁品敏感词列表。
● flood：灌水文本（指无意义的文本词语常见于贴吧 等灌水帖子）。
说明
● 灌水文本最多显示200个字符。
● 每个场景的返回结果的详细信息是指命中词，不是返回
状态码： 400
表4-7 响应 Body 参数
参数 参数类型 描述
error_cod
e String 调用失败时的错误码，具体请参见错误码。
调用成功时无此字段。
error_ms
g String 调用失败时的错误信息。
调用成功时无此字段。
fail_categ
ory String 当包含多个场景时，失败场景。
请求示例
POST https://{endpoint}/v2/{project_id}/moderation/text
{ "categories" : [ "ad", "politics", "abuse", "porn", "contraband", "flood" ], "items" : [ {
"text" : "asdfasdfasdf", "type" : "content"
} ] }
响应示例
状态码： 200 成功响应示例
{ "result" : { "detail" : {
"abuse" : [ "fuck" ] },
"suggestion" : "block"
}}
状态码： 400 失败响应示例
{ "error_code" : "AIS.0005",
"error_msg" : "The service does not exist."
}
状态码
状态码 描述
200 成功响应示例。
400 失败响应示例。
错误码
请参见错误码。