SDK参考

Size: px

Start display at page:

Download "SDK参考"

勿平谢
5 years ago
Views:

1 发布日期

2 目录目录 1 内容审核 SDK 环境搭建申请服务获取 SDK Java 开发环境配置 Eclipse 安装与 SDK 工程导入 AK/SK 认证文本审核文本内容检测示例图像审核图像内容检测示例图像反黄检测示例视频审核视频审核使用示例扭曲校正示例清晰度检测示例 Token 认证方式使用 SDK 接口与 API 的对应关系 A 附录 A.1 修订记录 ii

3 1 内容审核 SDK 环境搭建 1 内容审核 SDK 环境搭建 1.1 申请服务申请服务的具体操作步骤请参见内容审核 API 参考的接口调用方法 > 申请服务章节 1.2 获取 SDK 下载内容审核 SDK 软件包和文档, 链接如下 : sdk?moderation 1.3 Java 开发环境配置本 SDK 包要求的 JDK 版本必须高于 JDK8 版本, 以下步骤以 win7 环境配置 JDK8 64 位为例, 若已经下载 JDK 并配置好环境请忽略本章节步骤 1 步骤 2 步骤 3 步骤 4 下载 JDK 文件 : index.html 下载完成后按照提示安装, 位置自选, 比如安装到本地 C:\Program Files\Java \jdk1.8.0_131 配置 Java 环境变量 : 右键计算机 > 属性 > 高级系统设置 > 环境变量, 进行如下操作 1. 新建系统变量 JAVA_HOME, 变量值为实际 JDK 安装位置 2. 在 Path 中添加 %JAVA_HOME%\bin;%JAVA_HOME%\jre\bin ( 注意用英文分号分隔 ) 3. 新建系统变量 CLASSPATH, 变量值为 %JAVA_HOME%\lib\dt.jar;%JAVA_HOME% \lib\tools.jar 打开命令行窗口, 输入 java -version, 显示如图 1-1 表示配置成功

4 1 内容审核 SDK 环境搭建图 1-1 Java 版本信息 1.4 Eclipse 安装与 SDK 工程导入以 eclipse 工具为例给出 SDK 工程导入步骤, 如果使用其他 IDE 工具, 请参照处理 : 步骤 1 在下载对应平台的 eclipse 版本, 比如 : eclipse-jee-mars-r-win32-x86_64.zip 步骤 2 解压后直接打开 eclipse 步骤 3 步骤 4 步骤 5 确保 Windows>Preferences>Java>Installed JREs 配置正确的 JRE 路径在左边导航上选择 General > Workspace, 在 Text file encoding 区域, 选中 Other, 并设置参数值为 UTF-8, 单击 Apply 后, 单击 OK 在菜单栏依次选择 File>Import, 弹出导入工程窗口, 选择 Maven>Existing Maven Projects, 单击 Next, 单击 Browse, 选择 ais-moderation-java-sdk 所在的本地位置步骤 6 单击 Finish, 导入 SDK, 导入后打开工程, 工程目录如下 :

5 1 内容审核 SDK 环境搭建图 1-2 工程目录 1.5 AK/SK 认证使用服务 API 需要进行认证, 有 Token 和 AK/SK 两种认证方式可选, 推荐用户使用 AK/SK 方式步骤 1 注册并登录华为云管理控制台步骤 2 鼠标移动至用户名处, 在下拉列表中单击我的认证步骤 3 步骤 4 步骤 5 选择管理访问密钥页签, 点击新增访问秘钥按钮输入当前用户的登录密码, 通过邮箱或者手机进行验证, 输入对应的验证码单击确定, 下载认证账号的 AK/SK, 请妥善保管 AK/SK 信息

6 1 内容审核 SDK 环境搭建步骤 6 修改 ClientContextUtils.java 文件, 将如下信息替换成获取到的 AK/SK 图 1-3 修改 ClientContextUtils.java 文件

7 2.1 文本审核文本内容检测示例该文本内容检测 Demo 示例对应 URI:POST /v1.0/moderation/text 修改 AK/SK 后, 无需另外编写代码步骤 1 按照 AK/SK 认证配置用户 AK/SK 步骤 2 输入需要检测的文本, 参考图 2-1 修改 ModerationTextContentDemo.java 文件中输入文本的位置

8 图 2-1 提供检测的文本步骤 3 执行 ModerationTextContentDemo.java 文件, 控制台输出 200 即表示程序执行成功结果输出到控制台, 如图 2-2 所示图 2-2 运行结果 2.2 图像审核

2.2.1 图像内容检测示例该图像内容检测 Demo 示例对应 URI:POST /v1.0/moderation/image 修改 AK/SK 后, 无需另外编写代码步骤 1 按照 AK/SK 认证配置用户 AK/SK 步骤 2 选择本地图片或者使用 Demo 默认图片, 参考图 2-3 修改 ModerationImageContentDemo.

9 2.2.1 图像内容检测示例该图像内容检测 Demo 示例对应 URI:POST /v1.0/moderation/image 修改 AK/SK 后, 无需另外编写代码步骤 1 按照 AK/SK 认证配置用户 AK/SK 步骤 2 选择本地图片或者使用 Demo 默认图片, 参考图 2-3 修改 ModerationImageContentDemo.java 文件中图片文件路径图 2-3 图像文件路径步骤 3 执行 ModerationImageContentDemo.java 文件, 控制台输出 200 即表示程序执行成功结果输出到控制台, 如图 2-4 所示图 2-4 运行结果图像反黄检测示例该图像反黄检测 Demo 示例对应 URI:POST /v1.0/moderation/image/anti-porn 修改 AK/SK 后, 无需另外编写代码步骤 1 按照 AK/SK 认证配置用户 AK/SK 步骤 2 选择本地图片或者使用 Demo 默认图片, 参考图 2-5 修改 ModerationAntiPornDemo.java 文件中图片路径

10 图 2-5 图像路径步骤 3 执行 ModerationAntiPornDemo.java 文件, 控制台输出 200 即表示程序执行成功图像反黄检测识别结果输出到控制台, 如图 2-6 所示图 2-6 运行结果 2.3 视频审核视频审核使用示例该 Demo 的功能为将本地的视频文件上传到 obs 中并生成临时授权下载的 url, 用此 url 提交视频审核任务, 然后等待任务结束后打印视频审核结果运行 demo 的准备工作为配置 AK/SK 及保存视频文件用的 OBS 桶, 无需另外编写代码步骤 1 按照 AK/SK 认证配置用户 AK/SK 步骤 2 选择本地视频文件 ( 请注意不要超过 api 限制的视频大小, 详请参见内容审核 API 参考中 API 说明 > 视频审核 > 任务提交章节的表 1) 或者使用 Demo 默认视频, 参考图 1 OBS 桶和视频文件路径修改 VCMAkskDemo.java 文件中桶名

11 图 2-7 OBS 桶和视频文件路径步骤 3 执行 VCMAkskDemo.java 文件, 控制台输出提交任务成功并且最终输出视频审核结果则表示程序执行成功如图 2-8 所示

12 图 2-8 运行结果 2.4 扭曲校正示例该扭曲校正 Demo 示例对应 URI:POST /v1.0/moderation/image/distortion-correct 修改 AK/SK 后, 无需另外编写代码步骤 1 按照 AK/SK 认证配置用户 AK/SK 步骤 2 选择本地图片或者使用 Demo 默认图片, 参考图 2-9 修改 ModerationDistortionCorrectDemo.java 文件中图片路径图 2-9 图像文件路径步骤 3 指定扭曲校正后的图片保存路径, 参考图

13 图 2-10 执行成功后返回结果的保存文件步骤 4 执行 ModerationDistortionCorrectDemo.java 文件, 控制台输出 200 即表示程序执行成功, 参考图 2-11 扭曲校正返回的处理图片保存到步骤 3 中指定的文件中, 如图 2-12 所示图 2-11 运行结果

14 图 2-12 返回的处理图片保存结果 2.5 清晰度检测示例该清晰度检测 Demo 示例对应 URI:POST /v1.0/moderation/image/clarity-detect 修改 AK/SK 后, 无需另外编写代码步骤 1 按照 AK/SK 认证配置用户 AK/SK 步骤 2 选择本地图片或者使用 Demo 默认图片, 参考图 2-13 修改 ModerationClarityDemo.java 文件中图片路径

15 图 2-13 图像文件路径步骤 3 执行 ModerationClarityDemo.java 文件, 控制台输出 200 即表示程序执行成功清晰度检测识别结果输出到控制台, 如图 2-14 所示图 2-14 运行结果

16 3 Token 认证方式使用 SDK 3 Token 认证方式使用 SDK 服务认证方式有 Token 和 AK/SK 两种方式在本节 demo 示例中使用 Token 认证方式 ( 用户参照如下步骤操作后, 即可体验图像反黄检测, 用户修改用户名和密码后, 无需另外编写代码 ) 步骤 1 打开 com.huawei.ais.demo 包下面的 TokenDemo.java 文件, 修改 main 函数中的 username 和 password 为系统中实际注册的用户名和密码, 如图 3-1 所示图 3-1 修改用户名和密码步骤 2 修改后可直接运行 TokenDemo.java, 在控制台可看到使用 Token 方式各个内容审核服务的识别结果

17 4 接口与 API 的对应关系 4 接口与 API 的对应关系表 4-1 接口与 API 对应关系表接口图像审核 - 图像反黄检测图像审核 - 清晰度检测图像审核 - 扭曲校正图像审核 - 图像内容检测文本审核 - 文本内容检测视频审核 - 任务提交视频审核 - 任务列表查询视频审核 - 处理结果查询 API POST /v1.0/moderation/image/anti-porn POST /v1.0/moderation/image/clarity-detect POST /v1.0/moderation/image/distortioncorrect POST /v1.0/moderation/image POST /v1.0/moderation/text POST /v1.0/moderation/video GET /v1.0/moderation/video/jobs? status={status_type} GET /v1.0/moderation/video? job_id={job_id}

18 A 附录 A 附录 A.1 修订记录发布日期修改说明第四次正式发布新增 1. 视频审核第三次正式发布新增 1. 文本内容检测示例 2. 图像内容检测示例第二次正式发布新增 1. 清晰度检测示例 2. 扭曲校正示例第一次正式发布

SDK参考

SDK参考文档版本 03 发布日期 2018-07-30 华为技术有限公司版权所有华为技术有限公司 2018 保留一切权利非经本公司书面许可, 任何单位和个人不得擅自摘抄复制本文档内容的部分或全部, 并不得以任何形式传播商标声明和其他华为商标均为华为技术有限公司的商标本文档提及的其他所有商标或注册商标, 由各自的所有人拥有注意您购买的产品服务或特性等应受华为公司商业合同和条款的约束, 本文档中描述的全部或部分产品