文档版本 01
发布日期 2021-07-08
版权所有 © 华为技术有限公司 2021。 保留一切权利。
非经本公司书面许可,任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部,并不得以任何形式传 播。
商标声明
和其他华为商标均为华为技术有限公司的商标。
本文档提及的其他所有商标或注册商标,由各自的所有人拥有。
注意
您购买的产品、服务或特性等应受华为公司商业合同和条款的约束,本文档中描述的全部或部分产品、服务或 特性可能不在您的购买或使用范围之内。除非合同另有约定,华为公司对本文档内容不做任何明示或暗示的声 明或保证。
由于产品版本升级或其他原因,本文档内容会不定期进行更新。除非另有约定,本文档仅作为使用指导,本文 档中的所有陈述、信息和建议不构成任何明示或暗示的担保。
华为技术有限公司
地址: 深圳市龙岗区坂田华为总部办公楼 邮编:518129 网址:
https://www.huawei.com
客户服务邮箱:
[email protected]
客户服务电话:4008302118目 录
1 内容审核服务使用简介...1
2 如何使用 Postman 调用内容审核服务...2
2.1 内容审核-文本... 2
2.2 内容审核-图像... 8
3 如何使用 SDK 调用内容审核服务... 15
3.1 内容审核-文本... 15
3.2 内容审核-图像... 20
1 内容审核服务使用简介
内容审核(Content Moderation),是基于图像、文本、音视频的检测技术,可自动 检测涉黄、涉政涉暴、涉政敏感人物、图文违规等内容,对用户上传的图片、文字、
音视频进行内容审核,以满足上传要求,帮助客户降低业务违规风险。
内容审核以开放API(Application Programming Interface,应用程序编程接口)的方 式提供给用户,用户通过调用API获取推理结果,帮助用户打造智能化业务系统,提升 业务效率。目前内容审核包括内容审核-图像、内容审核-文本。
您可以根据以下介绍选择合适的使用方式:
● 通过华为云API Explorer在线调用内容审核服务API。
如果您是开发初学者,有代码编写基础,对HTTP请求与API调用有一定的了解,
想快速体验图像识别服务,该方式无需编码,只需要输入相关参数,即可调用 API,体验服务应用效果。
● 通过可视化工具(如curl、Postman)发送请求调用内容审核服务API。
如果您是开发工程师,熟悉代码编写,熟悉HTTP请求与API调用,您可以通过 postman调用、调试API。使用方法请参见如何使用Postman调用华为云
Moderation服务。
● 通过软件开发工具包(SDK)调用内容审核服务API。
如果您是开发工程师,熟悉代码编写,内容审核服务为您提供Java、Python、
PHP、Node.js等版本的SDK,方便您快速集成。使用方法请参见如何使用SDK调
用内容审核服务。
2 如何使用 Postman 调用内容审核服务
2.1 内容审核-文本
本章节提供了通过Postman调用“内容审核-文本”的样例,帮助您快速体验并熟悉使 用本服务,具体步骤如下:
步骤一:开通服务,用户在“服务列表”或“服务管理”页面选择内容审核-文本服务
申请开通。步骤二:配置自定义词库,用户可配置自定义白名单词库和自定义黑名单词库。
步骤三:配置环境,把准备的配置文件导入到开发环境中。
步骤四:Token认证鉴权,用户调用API接口时,需要使用Token进行鉴权。
步骤五:调用服务,调用API接口使用服务,使用过程中可以随时查看状态码与错误
码。步骤六:查看调用次数(可选),在控制台查看调用详情和调用次数统计。
步骤一:开通服务
内容审核-文本服务申请开通您可以按照如下步骤操作:
步骤1 登录华为云,申请华为云账号,并完成实名认证。
步骤2 在华为云页面顶部选择“人工智能 >内容审核-文本”。
步骤3 进入产品页,单击立即使用,输入您的华为云账号密码登录,进入内容审核管理控制 台。
步骤4 用户可以在内容审核管理控制台“服务列表”或“服务管理”页面申请开通服务。
以在“服务管理”页面开通服务为例,在商用服务栏目选择“文本内容审核”,单击
“开通服务”,进行服务使用申请。
说明
服务只需要开通一次即可,后面使用时无需再申请。
步骤5 商用服务申请成功后,在“服务管理”页面,“我的服务”中显示已经申请开通成功 的服务,此时,您可以通过调用API的方式使用内容审核-文本服务。
----结束
步骤二:配置自定义词库
文本内容审核服务可支持用户配置自定义白名单词库和自定义黑名单词库进行文本审 核。
● 创建自定义白名单词库:在使用文本内容审核服务时,您在白名单词库配置的内 容可以不被检测出。
具体操作步骤如下:
a. 登录华为云,单击右上角的“控制台”,进入“管理控制台”界面。
b. 单击“服务列表”,选择“人工智能 > 内容审核”,进入“内容审核”管理 页面。
c. 在左侧菜单栏中选择“服务列表>文本内容审核”服务。单击“自定义白名单 词库”后的“配置”按钮,进入“创建词库”页面。
图2-1 创建词库
d. 填写词库名称,输入新增的白名单关键词。单击“确定”,完成词库的创建
▪
名称:长度小于40个字符,只能包含字母、数字、中划线和下划线。▪
新增关键词:长度不大于40个字符,最多支持5000个关键词,每一行一 个关键词。● 创建自定义黑名单词库:在使用文本内容审核服务时,您在黑名单词库配置的内 容会被检测出。
具体操作步骤如下:
a. 登录华为云,单击右上角的“控制台”,进入“管理控制台”界面。
b. 单击“服务列表”,选择“人工智能 > 内容审核”,进入“内容审核”管理 页面。
c. 在左侧菜单栏中选择“服务列表>文本内容审核”服务。单击“自定义黑名单 词库”后的“配置”按钮,进入“自定义词库”页面。
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 查看监控数据。您可以单击“查看监控指标”在云监控控制台查看服务调用成功和失 败的次数等历史数据,如图2-9所示。
图2-9 监控数据
----结束
2.2 内容审核-图像
本章节提供了通过Postman调用“内容审核-图像”的样例,帮助您快速体验并熟悉使 用本服务,具体步骤如下:
步骤一:开通服务,用户在“服务列表”或“服务管理”页面选择内容审核-图像服务
申请开通。步骤二:对象存储服务OBS授权(可选),如果需要对OBS中的数据进行内容审核请
开通对象存储服务OBS授权。步骤三:配置审核规则(可选),可对涉暴、涉黄和涉政内容进行不同场景的检测。
步骤四:配置环境,把准备的配置文件导入到开发环境中。
步骤五:Token认证鉴权,用户调用API接口时,需要使用Token进行鉴权。
步骤六:调用服务,调用API接口使用服务,使用过程中可以随时查看状态码与错误
码。步骤七:查看调用次数(可选),在控制台查看调用详情和调用次数统计。
步骤一:开通服务
内容审核-图像服务申请开通您可以按照如下步骤操作:
步骤1 登录华为云,申请华为云账号,并完成实名认证。
步骤2 在华为云页面顶部选择“人工智能 > 内容审核-图像”。
步骤3 进入产品页,单击立即使用,输入您的华为云账号密码登录,进入内容审核管理控制 台。
步骤4 用户可以在内容审核管理控制台“服务列表”或“服务管理”页面申请开通服务。
以在服务管理页面开通服务为例。在商用服务“图像内容审核”或“图像鉴黄审核”
框,单击“开通服务”,进行服务使用申请。
说明
● 服务只需要开通一次即可,后面使用时无需再申请。
步骤5 商用服务申请成功后,在“服务管理”页面,“我的服务”中显示已经申请开通成功 的服务,此时,您可以通过调用API的方式使用内容审核-图像服务。
----结束
步骤二:对象存储服务 OBS 授权(可选)
如果您需要对OBS中的数据进行内容审核,请开通对象存储服务OBS授权。具体操作 步骤如下:
说明
1. Moderation不支持跨区域OBS,OBS的区域需要和服务保持一致。
2. OBS授权需要使用IAM主账号进行授权,不支持使用子账号进行授权。
步骤1 登录华为云内容审核管理控制台,单击进入“服务管理”页面。
步骤2 打开对象存储服务OBS授权的按钮 ,完成授权操作。
----结束
步骤三:配置审核规则(可选)
如果您需要对涉暴、涉黄和涉政内容进行不同场景的检测,可进行审核规则的配置。
具体操作步骤请参考配置审核规则。
步骤四:配置环境
1. 下载并安装Postman。
Postman建议使用7.24.0版本。
2. 下载内容审核服务Postman配置文件。
3. 导入配置文件。
a. 打开并登录Postman。
b. 单击左上角“File > Import ”在弹出的对话框中单击“Upload Files”导入 配置文件。
图2-10 导入配置文件
4. 配置文件导入成功后,将显示在Postman左侧导航栏的“Collections”目录下。
图2-11 配置文件
步骤五:Token 认证鉴权
Token是用户的访问令牌,承载了用户的身份、权限等信息,用户调用API接口时,需 要使用Token进行鉴权。
1. 在Postman左侧导航栏的“Collections”目录下,单击“get-token”配置文件。
2. 单击“Body”配置项。填写用户名、密码、账号名。
说明
用户名、密码、账号名的获取方法:
1. 登录管理控制台。
2. 鼠标移动至页面右上角的用户名,在下拉列表中单击“我的凭证”。复制IAM用户名、
主账号至username、domainname参数处,并填写该IAM用户密码。
图2-12 Token 认证鉴权
3. 单击“Send”,发送请求,来获取并复制Token。
获取返回结果“Headers”中的“X-Subject-Token”即为Token。Token有效期为 24小时。
图2-13 获取 Token
步骤六:调用服务
1. 在Postman左侧导航栏的“Collections”目录下单击“Moderation_image”配置 文件。
2. 单击“Headers”配置项,将获取的Token复制到“X-Auth-Token”值中。
图2-14 填入 Token
3. 单击“Body”配置项,将获取的图片的base64编码填写到“image”参数中。
– 关于body体中其他参数说明,请参考图像内容审核API。
图2-15 修改参数
4. 单击“Send”,发送请求,获取调用结果。
{ "result": {
"suggestion": "pass", "category_suggestions": { "politics": "pass", "terrorism": "pass", "porn": "pass"
}, "detail": { "politics": [], "terrorism": [ {
"confidence": 0.9989, "label": "normal"
} ], "porn": [ {
"confidence": 0.876, "label": "normal"
}, {
"confidence": 0.0338, "label": "porn"
}, {
"confidence": 0.0902, "label": "sexy"
} ] } } }
步骤七:查看调用次数(可选)
内容审核-图像API接口,分析并识别用户上传的图像内容是否有敏感内容(如色情、
政治等),并将识别结果返回给用户。
调用内容审核-图像API接口,您可以按照如下步骤操作:
步骤1 进入内容审核管理控制台。
步骤2 查看调用次数。您可以在“服务列表”,“图像内容审核”页查看调用详情和调用次 数统计。如图 调用统计所示。
图2-16 调用统计
● 调用次数统计模块有三张统计图分别显示每日审核的调用总量,每日block总量和 每日review总量。您可以设置时间范围来观察这段时间内的调用次数变化情况。
● 调用详情模块可以查看每日的调用次数总量,block总量,review总量以及pass总 量。您可以单击“导出”,将调用次数总量结果下载进行查看,帮助您更好了解 服务的调用情况和审核情况。
● 由于图像在OBS桶中存放,被判定为block和review的图像无法导出。
说明
– block表示包含敏感信息,不通过审核。
– pass表示不包含敏感信息,通过审核。
– review表示需要人工复查审核。
步骤3 查看监控数据。您可以单击“查看监控指标”在云监控控制台查看服务调用成功和失 败的次数等历史数据,如图2-17所示。
图2-17 监控数据
----结束
3 如何使用 SDK 调用内容审核服务
3.1 内容审核-文本
本章节提供了通过Java SDK调用“内容审核-文本”服务的样例,用户直接调用接口函 数即可使用SDK功能。具体流程如下:
步骤一:开通服务,用户在“服务列表”或“服务管理”页面选择内容审核-文本服务
申请开通。步骤二:配置自定义词库,用户可配置自定义白名单词库和自定义黑名单词库。
步骤三:配置环境,获取SDK和样例工程,导入到开发环境中。
步骤四:修改配置信息,使用AK/SK方式进行认证。
步骤五:调用服务,调用API接口使用服务,使用过程中可以随时查看状态码与错误
码。步骤一:开通服务
内容审核-文本服务申请开通您可以按照如下步骤操作:
步骤1 登录华为云,申请华为云账号,并完成实名认证。
步骤2 在华为云页面顶部选择“人工智能 > 内容审核-文本”。
步骤3 进入产品页,单击立即使用,输入您的华为云账号密码登录,进入内容审核管理控制 台。
步骤4 用户可以在内容审核管理控制台“服务列表”或“服务管理”页面申请开通服务。
以在“服务管理”页面开通服务为例,在商用服务栏目选择“文本内容审核”,单击
“开通服务”,进行服务使用申请。
说明
服务只需要开通一次即可,后面使用时无需再申请。
步骤5 商用服务申请成功后,在“服务管理”页面,“我的服务”中显示已经申请开通成功 的服务,此时,您可以通过调用API的方式使用内容审核-文本服务。
----结束
步骤二:配置自定义词库
文本内容审核服务可支持用户配置自定义白名单词库和自定义黑名单词库进行文本审 核。
1. 创建自定义白名单词库:在使用文本内容审核服务时,您在白名单词库配置的内 容可以不被检测出。
具体操作步骤如下:
步骤1 登录华为云,单击右上角的“控制台”,进入“管理控制台”界面。
步骤2 单击“服务列表”,选择“人工智能 > 内容审核”,进入“内容审核”管理页面。
步骤3 在左侧菜单栏中选择“服务列表>文本内容审核”服务。单击“自定义白名单词库”后 的“配置”按钮,进入“创建词库”页面。
图3-1 创建词库
步骤4 填写词库名称,输入新增的白名单关键词。单击“确定”,完成词库的创建
● 名称:长度小于40个字符,只能包含字母、数字、中划线和下划线。
● 新增关键词:长度不大于40个字符,最多支持5000个关键词,每一行一个关键 词。
----结束
2. 创建自定义黑名单词库:在使用文本内容审核服务时,您在黑名单词库配置的内容 会被检测出。
具体操作步骤如下:
步骤1 登录华为云,单击右上角的“控制台”,进入“管理控制台”界面。
步骤2 单击“服务列表”,选择“人工智能 > 内容审核”,进入“内容审核”管理页面。
步骤3 在左侧菜单栏中选择“服务列表>文本内容审核”服务。单击“自定义黑名单词库”后 的“配置”按钮,进入“自定义词库”页面。
步骤4 单击页面左上方“创建词库”,进入“创建词库”页面。填写词库名称,输入新增的 黑名单关键词。
● 名称:长度小于40个字符,只能包含字母、数字、中划线和下划线。
● 新增关键词:长度不大于40个字符,最多支持5000个关键词,每一行一个关键 词。
步骤5 单击“确定”,完成词库的创建。
说明
● 词库名称不支持修改。
----结束
步骤三:配置环境
您可以基于内容审核SDK通过编写代码的方式调用内容审核-文本API。在使用SDK和调 用API时您需要进行环境配置。具体操作步骤如下:
步骤1 获取内容审核SDK软件包和文档,请单击此处。
步骤2 环境配置请参见Java开发环境配置。
步骤3 以eclipse工具为例,导入SDK工程:
1. 打开Eclipse,确保“Windows >Preferences >Java >Installed JREs”配置正确的 JRE路径。
2. 在左边导航上选择“General > Workspace”,在“Text file encoding”区域选中
“Other”,并设置参数值为“UTF-8”,单击“Apply”后,单击“OK”。
3. 在菜单栏依次选择“File > Import”, 弹出导入工程窗口,选择“Maven >
Existing Maven Projects”,单击“Next”,单击“Browse”,选择“ais- moderation-java-sdk”所在的本地位置。
4. 单击Finish,导入SDK,导入后打开工程,工程目录如图3-2所示。
图3-2 工程目录
----结束
步骤四:修改配置信息
内容审核服务认证方式有Token和AK/SK两种方式,本示例中使用AK/SK方式进行认 证。
步骤1 获取AK/SK。
AK/SK即访问秘钥,请登录我的凭证页面,选择“访问密钥 > 新增访问密钥”获取。
步骤2 AK/SK认证鉴权,配置Java SDK中的AK/SK。
根据获取的AK/SK,修改工程目录中“ModerationTextContentDemo.java”文件中函 数的“AK”和“SK”的值。示例代码如下:
// 1. 配置好访问文本内容审核服务的基本信息,生成对应的一个客户端连接对象 AisAccess service = ServiceAccessBuilder.builder()
.ak("######") // your ak .sk("######") // your sk
.region("cn-north-4") // 内容审核服务支持华北-北京四(cn-north-4)、华东-上海一(cn-east-3)的 配置
.connectionTimeout(5000) // 连接目标url超时限制
.connectionRequestTimeout(1000) // 连接池获取可用连接超时限制 .socketTimeout(20000) // 获取服务器响应数据超时限制 .build();
步骤3 输入需要检测的文本,参考如下示例代码修改“ModerationTextContentDemo.java”
文件中输入文本的位置("6666666666")。
//// 2.构建访问文本内容审核服务需要的参数
//String uri = "/v1.0/moderation/text";
JSONObject json = new JSONObject();
json.put("categories", new String[] {"porn","politics","flood"}); //检测内容 JSONObject text = new JSONObject();
text.put("text", "6666666666");
text.put("type", "content");
JSONArray items = new JSONArray();
items.add(text);
json.put("items", items);
StringEntity stringEntity = new StringEntity(json.toJSONString(), "utf-8");
// 3.传入文本内容审核服务对应的uri参数, 传入文本内容审核服务需要的参数,
// 该参数主要通过JSON对象的方式传入, 使用POST方法调用服务 HttpResponse response = service.post(uri, stringEntity);
// 4.验证服务调用返回的状态是否成功,如果为200, 为成功, 否则失败。
ResponseProcessUtils.processResponseStatus(response);
----结束
步骤五:调用服务
步骤1 执行“ModerationTextContentDemo.java”文件,控制台输出200即表示程序执行成 功,文本内容审核结果输出到控制台,如图3-3所示。
图3-3 运行结果
步骤2 查看调用次数。您可以在“服务列表”,“文本内容审核”页查看调用详情和调用次 数统计。如图3-4所示。
图3-4 调用统计
● 调用次数统计模块有三张统计图分别显示每日审核的调用总量,每日block总量和 每日review总量。您可以设置时间范围来观察这段时间内的调用次数变化情况。
● 调用详情模块可以查看每日的调用次数总量,block总量,review总量以及pass总 量。帮助您更好了解服务的调用情况和审核情况。
说明
– block表示包含敏感信息,不通过审核。
– pass表示不包含敏感信息,通过审核。
– review表示需要人工复查审核。
步骤3 查看监控数据。您可以单击“查看监控指标”在云监控控制台查看服务调用成功和失 败的次数等历史数据,如图3-5所示。
图3-5 监控数据
----结束
3.2 内容审核-图像
本章节提供了通过Java SDK调用“内容审核-图像”服务的样例,用户直接调用接口函 数即可使用SDK功能。具体流程如下:
步骤一:开通服务,用户在“服务列表”或“服务管理”页面选择内容审核-图像服务
申请开通。步骤二:对象存储服务OBS授权(可选),如果需要对OBS中的数据进行内容审核请
开通对象存储服务OBS授权。步骤三:配置审核规则(可选),可对涉暴、涉黄和涉政内容进行不同场景的检测。
步骤四:配置环境,获取SDK和样例工程,导入到开发环境中。
步骤五:修改配置信息,使用AK/SK方式进行认证。
步骤五:调用服务,调用API接口使用服务,使用过程中可以随时查看状态码与错误
码。步骤一:开通服务
内容审核-图像服务申请开通您可以按照如下步骤操作:
步骤1 登录华为云,申请华为云账号,并完成实名认证。
步骤2 在华为云页面顶部选择“人工智能 > 内容审核-图像”。
步骤3 进入产品页,单击立即使用,输入您的华为云账号密码登录,进入内容审核管理控制 台。
步骤4 用户可以在内容审核管理控制台“服务列表”或“服务管理”页面申请开通服务。
以在服务管理页面开通服务为例。在商用服务“图像内容审核”或“图像鉴黄审核”
框,单击“开通服务”,进行服务使用申请。
说明
● 服务只需要开通一次即可,后面使用时无需再申请。
步骤5 商用服务申请成功后,在“服务管理”页面,“我的服务”中显示已经申请开通成功 的服务,此时,您可以通过调用API的方式使用内容审核-图像服务。
----结束
步骤二:对象存储服务 OBS 授权(可选)
如果您需要对OBS中的数据进行内容审核,请开通对象存储服务OBS授权。具体操作 步骤如下:
说明
1. Moderation不支持跨区域OBS,OBS的区域需要和服务保持一致。
2. OBS授权需要使用IAM主账号进行授权,不支持使用子账号进行授权。
步骤1 登录华为云内容审核管理控制台,单击进入“服务管理”页面。
步骤2 打开对象存储服务OBS授权的按钮 ,完成授权操作。
----结束
步骤三:配置审核规则(可选)
如果您需要对涉暴、涉黄和涉政内容进行不同场景的检测,可进行审核规则的配置。
具体操作步骤请参考配置审核规则。
步骤四:配置环境
您可以基于内容审核SDK通过编写代码的方式调用内容审核-文本API。在使用SDK和调 用API时您需要进行环境配置。具体操作步骤如下:
步骤1 获取内容审核SDK软件包和文档,请单击此处。
步骤2 环境配置请参见Java开发环境配置。
步骤3 以eclipse工具为例,导入SDK工程:
1. 打开Eclipse,确保“Windows >Preferences >Java >Installed JREs”配置正确的 JRE路径。
2. 在左边导航上选择“General > Workspace”,在“Text file encoding”区域选中
“Other”,并设置参数值为“UTF-8”,单击“Apply”后,单击“OK”。
3. 在菜单栏依次选择“File > Import”, 弹出导入工程窗口,选择“Maven >
Existing Maven Projects”,单击“Next”,单击“Browse”,选择“ais- moderation-java-sdk”所在的本地位置。
4. 单击Finish,导入SDK,导入后打开工程,工程目录如图3-6所示。
图3-6 工程目录
----结束
步骤五:修改配置信息
内容审核服务认证方式有Token和AK/SK两种方式,本示例中使用AK/SK方式进行认 证。
步骤1 获取AK/SK。
AK/SK即访问秘钥,请登录我的凭证页面,选择“访问密钥 > 新增访问密钥”获取。
步骤2 AK/SK认证鉴权,配置Java SDK中的AK/SK。
根据获取的AK/SK,修改工程目录中“ModerationImageContentDemo.java”文件中 函数的“AK”和“SK”的值。示例代码如下:
// 1. 配置好访问图像内容审核服务的基本信息,生成对应的一个客户端连接对象 AisAccess service = ServiceAccessBuilder.builder()
.ak("######") // your ak .sk("######") // your sk
.region("cn-north-4") // 内容审核服务支持华北-北京四(cn-north-4)、华东-上海一(cn-east-3)的配 置 .connectionTimeout(5000) // 连接目标url超时限制
.connectionRequestTimeout(1000) // 连接池获取可用连接超时限制 .socketTimeout(20000) // 获取服务器响应数据超时限制 .build();
步骤3 选择本地图片或者使用Demo默认图片,参考如下示例代码修改
“ModerationImageContentDemo.java”文件中图片文件路径(“data/moderation- demo-1.jpg”)。
public static void main(String[] args) throws IOException {
ModerationImageContentDemo tool = new ModerationImageContentDemo();
tool.imageContentCheck("https://sdk-obs-source-save.obs.cn-north-4.myhuaweicloud.com/
terrorism.jpg"); byte[] imageBytes = FileUtils.readFileToByteArray(new File("data/moderation- demo-1.jpg"));
tool.imageContentCheck(imageBytes);
}
----结束
步骤五:调用服务
步骤1 执行“ModerationImageContentDemo.java”文件,控制台输出200即表示程序执行 成功,图像内容审核结果输出到控制台,如图3-7所示。
图3-7 运行结果
步骤2 查看调用次数。您可以在“服务列表”,“图像内容审核”页查看调用详情和调用次 数统计。如图3-8所示。
图3-8 调用统计
● 调用次数统计模块有三张统计图分别显示每日审核的调用总量,每日block总量和 每日review总量。您可以设置时间范围来观察这段时间内的调用次数变化情况。
● 调用详情模块可以查看每日的调用次数总量,block总量,review总量以及pass总 量。您可以单击“导出”,将调用次数总量结果下载进行查看,帮助您更好了解 服务的调用情况和审核情况。
● 由于图像在OBS桶中存放,被判定为block和review的图像无法导出。
说明
– block表示包含敏感信息,不通过审核。
– pass表示不包含敏感信息,通过审核。
– review表示需要人工复查审核。
步骤3 查看监控数据。您可以单击“查看监控指标”在云监控控制台查看服务调用成功和失 败的次数等历史数据,如图3-9所示。
图3-9 监控数据
----结束