
# 调用SDK实现图像标签功能
本章节提供了通过Java SDK调用服务"图像标签"功能的样例，用户直接调用接口函数即可使用SDK功能。具体流程如下：
[步骤一：开通服务]，在"服务列表"或"服务管理"页面选择图像识别的服务申请开通。
[步骤二：对象存储服务OBS授权（可选）]，如果需要对OBS中的数据进行图像识别，请开通对象存储服务OBS授权。
[步骤三：配置环境]，在使用SDK和调用API前，先进行环境配置。
[步骤四：获取SDK示例]，获取SDK示例代码复制到项目中。
[步骤五：调用服务]，使用AK/SK方式进行认证，调用API接口使用服务。
 #### 步骤一：开通服务
图像识别服务申请开通您可以按照以下步骤进行操作：
1. 登录[华为云](https://www.huaweicloud.com)，申请华为账号，并完成实名认证。
2. 在[华为云](https://www.huaweicloud.com)页面顶部选择"EI企业智能\>人工智能\>图像识别 Image"。
3. 进入产品页，单击[立即使用](https://console.huaweicloud.com/image_recognition/?locale=zh-cn#/irs/services/imageTagging)，输入您注册的用户名密码，进入图像识别管理控制台。
4. 用户可以在图像识别管理控制台"服务列表"或"服务管理"页面申请开通服务。 
   以在"服务管理"页面开通"图像识别-图像标签"服务为例，在"商用服务"栏中选择"图像标签"，单击"开通服务"开通。
   ![](https://support.huaweicloud.com/qs-image/public_sys-resources/note_3.0-zh-cn.png)
   - 服务只需要开通一次即可，后面使用时无需再申请。
    
   
   
5. 商用服务申请成功后，在"服务管理"页面，"我的服务"中显示已经申请开通成功的服务，此时，您可以通过调用API接口的方式使用图像识别服务。
 
 #### 步骤二：对象存储服务OBS授权（可选）
如果您需要对OBS中的数据进行图像识别，请开通对象存储服务OBS授权。具体操作步骤如下：
![](https://support.huaweicloud.com/qs-image/public_sys-resources/note_3.0-zh-cn.png)
1. lmage不支持跨区域私有权限的OBS，OBS的区域需要和服务保持一致。
2. OBS授权需要使用IAM主账号进行授权，不支持使用子账号进行授权。
 
1. 登录华为云图像识别管理控制台，单击进入"服务管理"页面。
2. 打开对象存储服务OBS授权的按钮![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001409928836.png)，完成授权操作。
 
 #### 步骤三：配置环境
您可以基于图像识别SDK通过编写代码的方式调用图像识别服务API。在使用SDK和调用API时您需要进行环境配置。具体操作步骤如下：
1. 环境配置请参见[Java开发环境配置](https://support.huaweicloud.com/sdkreference-image/image_04_0004.html)。
2. 以IDEA工具为例，新建一个Maven项目，见[图1]所示。
   
   图1新建Maven项目   
   ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001583211269.png)
   
   
3. 在pom.xml中添加Image SDK依赖，请在[SDK开发者中心](https://sdkcenter.developer.huaweicloud.com/?product=image&language=Java)获取最新版本SDK。以3.1.37为例:
   
   ```
   <dependency>
         <groupId>com.huaweicloud.sdk</groupId>
         <artifactId>huaweicloud-sdk-core</artifactId>
   <!--建议更改为最新版本-->
         <version>3.1.37</version>
    </dependency>
    <dependency>
         <groupId>com.huaweicloud.sdk</groupId>
         <artifactId>huaweicloud-sdk-image</artifactId>
   <!--建议更改为最新版本-->
         <version>3.1.37</version>
   </dependency>
   ```
   
   
 
 #### 步骤四：获取SDK示例
获取图像标签V2 Java SDK示例代码。
1. 登录[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=Image&api=RunImageTagging),在"示例代码"中选择"Java"，如[图2]所示。
   图2示例代码   
   ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001532550804.png) 
2. 填写请求Body参数。输入url或者image参数，如[图3]所示。
   图3填写参数   
   ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001583595869.png) 
3. 复制示例代码到[配置环境]章节所创建的Maven项目中。
 
 #### 步骤五：调用服务
1. 图像识别服务认证方式有Token和AK/SK两种方式，本示例中使用AK/SK方式进行认证。 
   AK/SK即访问秘钥，请登录[我的凭证](https://console.huaweicloud.com/iam/#/myCredential)页面，选择"访问密钥 \> 新增访问密钥"获取。
   图4新增访问密钥   
   ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001533533402.png)
   
   
2. 运行示例代码，获取识别结果，如[图5]所示。
   
   图5运行示例   
   ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001583493361.png)
   
   
3. 查看调用次数。您可以在控制台的"概览"页查看调用总次数[图6]所示。
   
   图6调用统计   
   ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001583653649.png)
   
   
   
 
