本章节提供了通过Postman调用“内容审核-文本”的样例,帮助您快速体验并熟悉使 用本服务,具体步骤如下:
步骤一:开通服务,用户在“服务列表”或“服务管理”页面选择内容审核-文本服务
申请开通。步骤二:配置自定义词库,用户可配置自定义白名单词库和自定义黑名单词库。
步骤三:配置环境,把准备的配置文件导入到开发环境中。
步骤四:Token认证鉴权,用户调用API接口时,需要使用Token进行鉴权。
步骤五:调用服务,调用API接口使用服务,使用过程中可以随时查看状态码与错误
码。步骤六:查看调用次数(可选),在控制台查看调用详情和调用次数统计。
步骤一:开通服务
内容审核-文本服务申请开通您可以按照如下步骤操作:
步骤1 登录华为云,申请华为云账号,并完成实名认证。
步骤2 在华为云页面顶部选择“人工智能 >内容审核-文本”。
步骤3 进入产品页,单击立即使用,输入您的华为云账号密码登录,进入内容审核管理控制 台。
步骤4 用户可以在内容审核管理控制台“服务列表”或“服务管理”页面申请开通服务。
以在“服务管理”页面开通服务为例,在商用服务栏目选择“文本内容审核”,单击
“开通服务”,进行服务使用申请。
说明
服务只需要开通一次即可,后面使用时无需再申请。
步骤5 商用服务申请成功后,在“服务管理”页面,“我的服务”中显示已经申请开通成功
▪
新增关键词:长度不大于40个字符,最多支持5000个关键词,每一行一 个关键词。d. 单击页面左上方“创建词库”,进入“创建词库”页面。填写词库名称,输 入新增的黑名单关键词。
i. 名称:长度小于40个字符,只能包含字母、数字、中划线和下划线。
ii. 新增关键词:长度不大于40个字符,最多支持5000个关键词,每一行一 个关键词。
e. 单击“确定”,完成词库的创建。
说明
● 词库名称不支持修改。
步骤三:配置环境
1. 下载并安装Postman。
Postman建议使用7.24.0版本。
2. 下载内容审核服务Postman配置文件。
3. 导入配置文件。
a. 打开并登录Postman。
b. 单击左上角“File > Import ”在弹出的对话框中单击“Upload Files”导入 配置文件。
图2-2 导入配置文件
4. 配置文件导入成功后,将显示在Postman左侧导航栏的“Collections”目录下。
图2-3 配置文件
步骤四:Token 认证鉴权
Token是用户的访问令牌,承载了用户的身份、权限等信息,用户调用API接口时,需 要使用Token进行鉴权。
1. 在Postman左侧导航栏的“Collections”目录下,单击“get-token”配置文件。
2. 单击“Body”配置项。填写用户名、密码、账号名。
说明
用户名、密码、账号名的获取方法:
1. 登录管理控制台。
2. 鼠标移动至页面右上角的用户名,在下拉列表中单击“我的凭证”。复制IAM用户名、
主账号至username、domainname参数处,并填写该IAM用户密码。
图2-4 Token 认证鉴权
3. 单击“Send”,发送请求,来获取并复制Token。
获取返回结果“Headers”中的“X-Subject-Token”即为Token。Token有效期为 24小时。
图2-5 获取 Token
步骤五:调用服务
1. 在Postman左侧导航栏的“Collections”目录下单击“Moderation_image”配置 文件。
2. 单击“Headers”配置项,将获取的Token复制到“X-Auth-Token”值中。
图2-6 填入 Token
3. 单击“Body”配置项,将待检测的文本填入到“text”参数中。
– 关于body体中其他参数说明,请参考文本内容审核API。
图2-7 修改参数
4. 单击“Send”,发送请求,获取调用结果。
{ "result": { "detail": {}, "suggestion": "pass"
} }
步骤六:查看调用次数(可选)
步骤1 查看调用次数。您可以在“服务列表”,“文本内容审核”页查看调用详情和调用次 数统计。如图 调用统计所示。
图2-8 调用统计
● 调用次数统计模块有三张统计图分别显示每日审核的调用总量,每日block总量和 每日review总量。您可以设置时间范围来观察这段时间内的调用次数变化情况。
● 调用详情模块可以查看每日的调用次数总量,block总量,review总量以及pass总 量。帮助您更好了解服务的调用情况和审核情况。
说明
– block表示包含敏感信息,不通过审核。
– pass表示不包含敏感信息,通过审核。
– review表示需要人工复查审核。
步骤2 查看监控数据。您可以单击“查看监控指标”在云监控控制台查看服务调用成功和失