SDK参考

Size: px

Start display at page:

Download "SDK参考"

珈贤支
4 years ago
Views:

1 文档版本 10 发布日期华为技术有限公司

2 版权所有华为技术有限公司 2019 保留一切权利非经本公司书面许可, 任何单位和个人不得擅自摘抄复制本文档内容的部分或全部, 并不得以任何形式传播商标声明和其他华为商标均为华为技术有限公司的商标本文档提及的其他所有商标或注册商标, 由各自的所有人拥有注意您购买的产品服务或特性等应受华为公司商业合同和条款的约束, 本文档中描述的全部或部分产品服务或特性可能不在您的购买或使用范围之内除非合同另有约定, 华为公司对本文档内容不做任何明示或默示的声明或保证由于产品版本升级或其他原因, 本文档内容会不定期进行更新除非另有约定, 本文档仅作为使用指导, 本文档中的所有陈述信息和建议不构成任何明示或暗示的担保华为技术有限公司地址 : 深圳市龙岗区坂田华为总部办公楼邮编 : 网址 : 客户服务邮箱 : support@huawei.com 客户服务电话 : 文档版本 10 ( ) 版权所有华为技术有限公司 i

4 1 SDK 简介 1 SDK 简介概述 (Image Recognition), 是指利用计算机对图像进行处理分析和理解, 以识别各种不同模式的目标和对象的技术, 并对质量不佳的图像进行一系列的增强与重建技术手段, 从而有效改善图像质量以开放 API(Application Programming Interface, 应用程序编程接口 ) 的方式提供给用户, 用户通过实时访问和调用 API 获取推理结果, 帮助用户自动采集关键数据, 打造智能化业务系统, 提升业务效率 SDK 概述软件开发工具包 (Image Recognition Software Development Kit, 简称 Image SDK) 是对提供的 REST API 进行的封装, 以简化用户的开发工作用户直接调用 Image SDK 提供的接口函数即可实现使用业务能力的目的接口与 API 对应关系接口与 API 对应关系请参见表 1-1 表 1-1 接口与 API 对应关系表接口图像标签名人识别翻拍识别低光照增强图像去雾超分图像重建视频背景音乐识别 API POST /v1.0/image/tagging POST /v1.0/image/celebrity-recognition POST /v1.0/image/recapture-detect POST /v1.0/vision/dark-enhance POST /v1.0/vision/defog POST /v1.0/vision/super-resolution POST /v1.0/bgm/recognition 文档版本 10 ( ) 版权所有华为技术有限公司 1

6 3 获取认证信息 3 获取认证信息使用服务 API 需要进行认证, 有 Token 和 AK/SK 两种认证方式可选, 推荐用户使用 AK/SK 方式步骤 1 注册并登录华为云管理控制台步骤 2 鼠标移动至用户名处, 在下拉列表中单击我的凭证步骤 4 步骤 5 选择管理访问密钥页签, 点击新增访问秘钥按钮输入当前用户的登录密码, 通过邮箱或者手机进行验证, 输入对应的验证码单击确定, 下载认证账号的 AK/SK, 请妥善保管 AK/SK 信息文档版本 10 ( ) 版权所有华为技术有限公司 3

9 6.1 Java 开发环境配置本 SDK 包要求的 JDK 版本必须高于 JDK8 版本, 以下步骤以 win7 环境配置 JDK8 64 位为例, 若已经下载 JDK 并配置好环境请忽略本章节步骤 1 步骤 2 步骤 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, 显示如图 6-1 表示配置成功图 6-1 Java 版本信息 6.2 Eclipse 安装与 SDK 工程导入以 eclipse 工具为例给出 SDK 工程导入步骤, 如果使用其他 IDE 工具, 请参照如下处理 : 步骤 1 在下载对应平台的 eclipse 版本, 例如 : eclipse-jee-mars-r-win32-x86_64.zip 文档版本 10 ( ) 版权所有华为技术有限公司 6

步骤 2 解压后直接打开 eclipse 步骤 4 步骤 5 确保 Windows>Preferences>Java>Installed JREs 配置正确的 JRE 路径在左侧 Package Explorer 页面右键, 单击 Import, 选择 Maven>Existing Maven Projects, 单击 Next, 单击 Browse, 选择

10 步骤 2 解压后直接打开 eclipse 步骤 4 步骤 5 确保 Windows>Preferences>Java>Installed JREs 配置正确的 JRE 路径在左侧 Package Explorer 页面右键, 单击 Import, 选择 Maven>Existing Maven Projects, 单击 Next, 单击 Browse, 选择 ais-image-java-sdk 所在的本地位置单击 Finish, 导入 SDK, 导入后打开工程, 工程目录如图 6-2 所示图 6-2 工程目录 6.3 图像标签示例服务认证方式有 Token 和 AK/SK 两种方式, 本章节对 AK/SK 方式使用 SDK 进行示例说明该图像标签 Demo 示例对应 URI:POST /v1.0/image/tagging 修改 AK/SK 后, 无需更改其它代码步骤 1 在 ImageTaggingDemo.java 文件中配置用户 AK/SK 示例代码如下 : 1. 图片标签服务的的基本信息, 生成对应的一个客户端连接对象 AisAccess service = ServiceAccessBuilder.builder().ak("######") your ak.sk("######") your sk 文档版本 10 ( ) 版权所有华为技术有限公司 7

11 .region("cn-north-1") 服务华北 - 北京一 (cn-north-1) 的配置.connectionTimeout(5000) 连接目标 url 超时限制.connectionRequestTimeout(1000) 连接池获取可用连接超时限制.socketTimeout(20000) 获取服务器响应数据超时限制.build(); 步骤 2 选择本地图片或者使用 Demo 默认图片, 参考如下示例代码修改 ImageTaggingDemo.java 文件中图片路径 ("data/image-tagging-demo-1.jpg") 2. 构建访问图片标签服务需要的参数 String uri = "/v1.0/image/tagging"; byte[] filedata = FileUtils.readFileToByteArray(new File("data/image-tagging-demo-1.jpg")); String filebase64str = Base64.encodeBase64String(fileData); 执行 ImageTaggingDemo.java 文件, 控制台输出 200 即表示程序执行成功图像标签识别结果会输出到控制台, 如图 6-3 所示图 6-3 运行结果 6.4 名人识别示例服务认证方式有 Token 和 AK/SK 两种方式, 本章节对 AK/SK 方式使用 SDK 进行示例说明该名人识别 Demo 示例对应 URI:POST /v1.0/image/celebrity-recognition 修改 AK/SK 后, 无需另外编写代码步骤 1 在 CelebrityRecognitionDemo.java 文件中配置用户 AK/SK 示例代码如下 : 1. 名人识别服务的的基本信息, 生成对应的一个客户端连接对象 AisAccess service = ServiceAccessBuilder.builder().ak("######") your ak.sk("######") your sk.region("cn-north-1") 服务华北 - 北京一 (cn-north-1) 的配置.connectionTimeout(5000) 连接目标 url 超时限制.connectionRequestTimeout(1000) 连接池获取可用连接超时限制.socketTimeout(20000) 获取服务器响应数据超时限制.build(); 步骤 2 选择一张政治人物或者网络红人的人像图片, 参考如下示例代码修改 CelebrityRecognitionDemo.java 文件中图片路径 ("data/image-tagging-demo-1.jpg") 2. 构建访问名人识别服务需要的参数 String uri = "/v1.0/image/celebrity-recognition"; /** * TODO 运行此样例时可在 data 目录放入待识别的人像图片, 此处仅用一张非人像图片表明设置文件名的位置 */ byte[] filedata = FileUtils.readFileToByteArray(new File("data/image-tagging-demo-1.jpg")); String filebase64str = Base64.encodeBase64String(fileData); 执行 CelebrityRecognitionDemo.java 文件, 控制台输出 200 即表示程序执行成功名人识别结果输出到控制台 ( 由于样例默认图片中无人像, 所以结果为空 ), 如图 6-4 所示文档版本 10 ( ) 版权所有华为技术有限公司 8

12 图 6-4 运行结果 6.5 翻拍识别示例服务认证方式有 Token 和 AK/SK 两种方式, 本章节对 AK/SK 方式使用 SDK 进行示例说明该翻拍识别 Demo 示例对应 URI:POST /v1.0/image/recapture-detect 修改 AK/SK 后, 无需更改其它代码步骤 1 在 RecaptureDetectionDemo.java 文件中配置用户 AK/SK 示例代码如下 : 1. 翻拍识别服务的基本信息, 生成对应的一个客户端连接对象 AisAccess service = ServiceAccessBuilder.builder().ak("######") your ak.sk("######") your sk.region("cn-north-1") 服务华北 - 北京一 (cn-north-1) 的配置.connectionTimeout(5000) 连接目标 url 超时限制.connectionRequestTimeout(1000) 连接池获取可用连接超时限制.socketTimeout(20000) 获取服务器响应数据超时限制.build(); 步骤 2 选择本地图片或者使用 Demo 默认图片, 参考如下示例代码修改 RecaptureDetectionDemo.java 文件中图片路径 ("data/recapture-detect-demo-1.jpg") 2. 构建访问翻拍识别服务需要的参数 String uri = "/v1.0/image/recapture-detect"; byte[] filedata = FileUtils.readFileToByteArray(new File("data/recapture-detect-demo-1.jpg")); String filebase64str = Base64.encodeBase64String(fileData); 执行 RecaptureDetectionDemo.java 文件, 控制台输出 200 即表示程序执行成功图像标签识别结果输出到控制台, 如图 6-5 所示图 6-5 运行结果 6.6 低光照增强示例服务认证方式有 Token 和 AK/SK 两种方式, 本章节对 AK/SK 方式使用 SDK 进行示例说明该低光照增强 Demo 示例对应 URI:POST /v1.0/vision/dark-enhance 修改 AK/SK 后, 无需另外编写代码文档版本 10 ( ) 版权所有华为技术有限公司 9

步骤 1 在 DarkEnhanceDemo.java 文件中配置用户 AK/SK 示例代码如下 : 1. 配置好低光照增强服务的的基本信息, 生成对应的一个客户端连接对象 AisAccess service = ServiceAccessBuilder.builder().ak("######") your ak.sk("######") your sk.

13 步骤 1 在 DarkEnhanceDemo.java 文件中配置用户 AK/SK 示例代码如下 : 1. 配置好低光照增强服务的的基本信息, 生成对应的一个客户端连接对象 AisAccess service = ServiceAccessBuilder.builder().ak("######") your ak.sk("######") your sk.region("cn-north-1") 服务华北 - 北京一 (cn-north-1) 的配置.connectionTimeout(5000) 连接目标 url 超时限制.connectionRequestTimeout(1000) 连接池获取可用连接超时限制.socketTimeout(20000) 获取服务器响应数据超时限制.build(); 步骤 2 选择本地图片或者使用 Demo 默认图片, 参考如下示例代码修改 DarkEnhanceDemo.java 文件中原图片路径 ("data/dark-enhance-demo-1.bmp") 和处理后生成图像保存路径 ("data/dark-enhance-demo-1.cooked.bmp") 2. 构建访问低光照增强服务需要的参数 String uri = "/v1.0/vision/dark-enhance"; byte[] filedata = FileUtils.readFileToByteArray(new File("data/dark-enhance-demo-1.bmp")); String filebase64str = Base64.encodeBase64String(fileData); JSONObject json = new JSONObject(); json.put("image", filebase64str); json.put("brightness", 0.9); 3. 传入低光照增强服务对应的 uri 参数, 传入低光照增强服务需要的参数, 该参数主要通过 JSON 对象的方式传入, 使用 POST 方法调用服务 HttpResponse response = service.post(uri, json.tojsonstring()); 4. 验证服务调用返回的状态是否成功, 如果为 200, 为成功, 否则失败 ResponseProcessUtils.processResponseStatus(response); 5. 处理服务返回的字符流, 生成对应的低光照增强处理后对应的图片文件 ResponseProcessUtils.processResponseWithImage(response, "data/dark-enhance-demo-1.cooked.bmp"); 执行 DarkEnhanceDemo.java 文件, 控制台输出 200 即表示程序执行成功低光照增强的原图与处理效果图对比如图 6-6 所示图 6-6 原图与处理效果图对比文档版本 10 ( ) 版权所有华为技术有限公司 10

14 6.7 图像去雾示例服务认证方式有 Token 和 AK/SK 两种方式, 本章节对 AK/SK 方式使用 SDK 进行示例说明该图像去雾 Demo 示例对应 URI:POST /v1.0/vision/defog 修改 AK/SK 后, 无需另外编写代码步骤 1 在 DefogDemo.java 文件中配置用户 AK/SK 示例代码如下 : 1. 配置好去雾服务的的基本信息, 生成对应的一个客户端连接对象 AisAccess service = ServiceAccessBuilder.builder().ak("######") your ak.sk("######") your sk.region("cn-north-1") 服务华北 - 北京一 (cn-north-1) 的配置.connectionTimeout(5000) 连接目标 url 超时限制.connectionRequestTimeout(1000) 连接池获取可用连接超时限制.socketTimeout(20000) 获取服务器响应数据超时限制.build(); 步骤 2 选择本地图片或者使用 Demo 默认图片, 参考如下示例代码修改 DefogDemo.java 文件中原图片路径 ("data/defog-demo-1.png") 和处理后生成图像保存路径 ("data/defogdemo-1.cooked.png") 2. 构建访问去雾服务需要的参数 String uri = "/v1.0/vision/defog"; byte[] filedata = FileUtils.readFileToByteArray(new File("data/defog-demo-1.png")); String filebase64str = Base64.encodeBase64String(fileData); JSONObject json = new JSONObject(); json.put("image", filebase64str); json.put("gamma", 1.5); json.put("natural_look", true); 3. 传入去雾服务对应的 uri 参数, 传入去雾服务需要的参数, 该参数主要通过 JSON 对象的方式传入, 使用 POST 方法调用服务 HttpResponse response = service.post(uri, json.tojsonstring()); 4. 验证服务调用返回的状态是否成功, 如果为 200, 为成功, 否则失败 ResponseProcessUtils.processResponseStatus(response); 5. 处理服务返回的字符流, 生成对应的去雾处理后对应的图片文件 ResponseProcessUtils.processResponseWithImage(response, "data/defog-demo-1.cooked.png"); 执行 DefogDemo.java 文件, 控制台输出 200 即表示程序执行成功图像去雾的原图与处理效果图对比如图 6-7 文档版本 10 ( ) 版权所有华为技术有限公司 11

15 图 6-7 原图与处理效果图对比 6.8 超分图像重建示例服务认证方式有 Token 和 AK/SK 两种方式, 本章节对 AK/SK 方式使用 SDK 进行示例说明该超分图像重建 Demo 示例对应 URI:POST /v1.0/vision/super-resolution 修改 AK/SK 后, 无需另外编写代码步骤 1 在 SuperResolutionDemo 文件中配置用户 AK/SK 示例代码如下 : 1. 配置好超分图像重建服务的的基本信息, 生成对应的一个客户端连接对象 AisAccess service = ServiceAccessBuilder.builder().ak("######") your ak.sk("######") your sk.region("cn-north-1") 服务华北 - 北京一 (cn-north-1) 的配置.connectionTimeout(5000) 连接目标 url 超时限制.connectionRequestTimeout(1000) 连接池获取可用连接超时限制.socketTimeout(20000) 获取服务器响应数据超时限制.build(); 步骤 2 选择本地图片或者使用 Demo 默认图片, 参考如下示例代码修改 SuperResolutionDemo.java 文件中原图片路径 ("data/super-resolution-demo-1.png") 和处理后生成图像保存路径 ("data/super-resolution-demo-1.cooked.png") 2. 构建访问超分图像重建服务需要的参数 String uri = "/v1.0/vision/super-resolution"; byte[] filedata = FileUtils.readFileToByteArray(new File("data/super-resolution-demo-1.png")); String filebase64str = Base64.encodeBase64String(fileData); JSONObject json = new JSONObject(); json.put("image", filebase64str); json.put("scale", 3); json.put("model", "ESPCN"); 3. 传入超分图像重建服务对应的 uri 参数, 传入超分图像重建服务需要的参数, 该参数主要通过 JSON 对象的方式传入, 使用 POST 方法调用服务 HttpResponse response = service.post(uri, json.tojsonstring()); 4. 验证服务调用返回的状态是否成功, 如果为 200, 为成功, 否则失败文档版本 10 ( ) 版权所有华为技术有限公司 12

ResponseProcessUtils.processResponseStatus(response); 5. 处理服务返回的字符流, 生成对应的超分图像重建处理后对应的图片文件 ResponseProcessUtils.processResponseWithImage(response, "data/super-resolution-demo-1.cooked.

16 ResponseProcessUtils.processResponseStatus(response); 5. 处理服务返回的字符流, 生成对应的超分图像重建处理后对应的图片文件 ResponseProcessUtils.processResponseWithImage(response, "data/super-resolution-demo-1.cooked.png"); 执行 SuperResolutionDemo.java 文件, 控制台输出 200 即表示程序执行成功超分图像重建的原图与处理效果图对比如图 6-8 图 6-8 原图与处理效果图对比 6.9 视频背景音乐识别示例服务认证方式有 Token 和 AK/SK 两种方式, 本章节对 AK/SK 方式使用 SDK 进行示例说明视频背景音乐识别 Demo 示例对应 URI:POST /v1.0/bgm/recognition 修改 AK/SK 后, 无需更改其它代码步骤 1 在 ASRBgmDemo.java 文件中配置用户 AK/SK 示例代码如下 : 步骤 2 1. 视频背景音乐识别服务的的基本信息, 生成对应的一个客户端连接对象 AisAccess service = ServiceAccessBuilder.builder().ak("######") your ak.sk("######") your sk.region("cn-north-1") 服务华北 - 北京一 (cn-north-1) 的配置.connectionTimeout(5000) 连接目标 url 超时限制.connectionRequestTimeout(1000) 连接池获取可用连接超时限制.socketTimeout(20000) 获取服务器响应数据超时限制.build(); 将 ASRBgmDemo.java 文件中视频的 URL 修改为 OBS 中视频的 URL(" 示例代码如下 : JSONObject json = new JSONObject(); 视频的 OBS URL ( 注 :obs 链接需要和 region 区域一致, 不同的 region 的 obs 资源不共享 ) String url = " json.put("url", url); 3. 传入视频背景音乐识别服务对应的 uri 参数, 传入视频背景音乐识别服务需要的参数, 该参数主要通过 JSON 对象的方式传入, 使用 POST 方法调用服务 HttpResponse response = service.post(uri, json.tojsonstring()); 4. 验证服务调用返回的状态是否成功, 如果为 200, 为成功, 否则失败 ResponseProcessUtils.processResponseStatus(response); 说明需要传入 obs 链接的服务, 链接需要和所在 region 区域一致, 不同的 region 的 obs 资源不共享文档版本 10 ( ) 版权所有华为技术有限公司 13

17 执行 ASRBgmDemo.java 文件, 控制台输出 200 即表示程序执行成功视频背景音乐识别结果输出到控制台, 如图 6-9 所示图 6-9 运行结果 6.10 Token 认证方式使用 SDK 服务认证方式有 Token 和 AK/SK 两种方式, 在本节 Demo 示例中使用 Token 认证方式 ( 用户参照如下步骤操作后, 即可体验图像标签服务, 用户修改用户名和密码后, 无需另外编写代码 ) 步骤 1 打开 com.huawei.ais.demo 包下面的 TokenDemo.java 文件, 修改 main 函数中的 username 和 password 为系统中实际注册的用户名和密码, 示例代码如下 : /** * 调用主入口函数 */ public static void main(string[] args) throws URISyntaxException, UnsupportedOperationException, IOException { String username = "zhangshan"; 此处, 请输入用户名 String password = "*******"; 此处, 请输入对应用户名的密码 String token = gettoken(username, password, projectname); System.out.println(token); requestimagetaggingbase64(token, "data/image-tagging-demo-1.jpg"); } 步骤 2 修改后可直接运行 TokenDemo.java, 在控制台可看到使用 Token 方式图像标签服务的识别结果文档版本 10 ( ) 版权所有华为技术有限公司 14

18 7 修订记录 7 修订记录发布日期修订说明第十次正式发布修改获取认证信息章节使用 SDK(Java) 章节第九次正式发布修改第八次正式发布将对应 Endpoint 修改为 image.cnnorth-1.myhuaweicloud.com 新增视频背景音乐识别示例第七次正式发布新增 SDK 简介准备环境第六次正式发布新增名人识别示例第五次正式发布修改第四次正式发布申请服务操作步骤参见文档为 API 参考修改 Eclipse 安装与 SDK 工程导入, 修改工程导入路径文档版本 10 ( ) 版权所有华为技术有限公司 15

SDK参考

SDK参考发布日期 2018-10-23 目录目录 1 内容审核 SDK 环境搭建... 1 1.1 申请服务... 1 1.2 获取 SDK... 1 1.3 Java 开发环境配置... 1 1.4 Eclipse 安装与 SDK 工程导入... 2 1.5 AK/SK 认证... 3... 5 2.1 文本审核... 5 2.1.1 文本内容检测示例... 5 2.2 图像审核... 6 2.2.1