内容审核-文本

步骤一：开通服务

内容审核-文本服务开通步骤请参考开通服务步骤说明。

步骤二：配置自定义词库

文本内容审核服务可支持用户配置自定义白名单词库和自定义黑名单词库进行文本审核。

具体步骤请参考创建自定义词库。

步骤三：配置环境

下载并安装Postman。Postman建议使用7.24.0版本。

步骤四：Token认证鉴权

Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。

1. 在Postman左侧导航栏的“Collections”目录下，单击“get-token”配置文件。
2. 单击“Body”配置项。填写用户名、密码、账号名。
   

   用户名、密码、账号名的获取方法：

   1. 登录管理控制台。
   2. 鼠标移动至页面右上角的用户名，在下拉列表中单击“我的凭证”。复制IAM用户名、主账号至username、domainname参数处，并填写该IAM用户密码。
   图1 Token认证鉴权
   
3. 单击“Send”，发送请求，来获取并复制Token。

   获取返回结果“Headers”中的“X-Subject-Token”即为Token。Token有效期为24小时。

   图2 获取Token
   

步骤五：调用服务

1. 在Postman左侧导航栏的“Collections”目录下单击“Moderation_text”配置文件。
2. 单击“Headers”配置项，将获取的Token复制到“X-Auth-Token”值中。
   图3 填入Token
   
3. 单击“Body”配置项，将待检测的文本填入到“text”参数中。
   • 关于body体中其他参数说明，请参考文本内容审核API。
     图4 修改参数
     
4. 单击“Send”，发送请求，获取调用结果。

   {
       "request_id": "065561ff4bba1af6dd63a27c5c1371de",
       "result": {
           "details": [],
           "label": "normal",
           "suggestion": "pass"
       }
   }  
   

步骤六：查看调用次数（可选）

1. 登录内容审核服务管理控制台。
2. 在左侧导航栏中选择“内容审核 V3>识别统计>文本审核”，可以查看识别统计详情，如图5所示。您可以设置时间范围，策略（事件类型）来观察这段时间内的调用次数变化情况。
   图5 识别统计
   
   • 识别结果统计：显示一段时间范围，内容审核的调用总数，拒绝数，疑似数和通过数，帮助您更好了解服务的调用情况和审核情况。
     • 总数：指的是审核调用总次数。
     • 拒绝数：指的是block总数，即文本中包含敏感信息，审核不通过的次数。
     • 疑似数：指的是review总数，即人工复查审核的次数。
     • 通过数：指的是pass总数，即通过审核的次数。
   • 数据趋势：显示您设置的这段时间范围内，总数，拒绝数，疑似数和通过数的变化趋势。

     

   • 拒绝数据原因分布：显示您设置的这段时间范围内，审核不通过的检测场景占比数。
   • 疑似数据原因分布：显示您设置的这段时间范围内，需要人工复查的检测场景占比数。