# 调用API实现图像标签功能
本章节提供了通过Postman调用Image服务"图像标签"的样例，帮助您零编码快速体验并熟悉本服务，具体流程如下：
[步骤一：开通服务]，用户在"服务列表"或"服务管理"页面选择图像识别的服务申请开通。
[步骤二：对象存储服务OBS授权（可选）]，如果需要对OBS中的数据进行图像识别，请开通对象存储服务OBS授权。
[步骤三：配置环境]，获取SDK和样例工程，导入到开发环境中。
[步骤四：Token认证鉴权]，调用API的时候将Token加到请求消息头，从而通过身份认证获得操作API的权限。
[步骤五：调用服务]，调用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_0000001460288593.png)，完成授权操作。
 
 #### 步骤三：配置环境
下载并安装Postman。Postman建议使用7.24.0版本。
 #### 步骤四：Token认证鉴权
1. 在Postman界面，选择"New \> Collection"，设置相应的名称并单击"Create"完成创建。 ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001410093132.png)
   
2. 选择创建的Collection，单击鼠标右键，选择"Add Request"，设置Request name并单击"Save"。 ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001409933156.png)
   
3. 请求方式修改为"POST"，输入URL。 例如，以cn-north-4为例，URL为"https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens"。
   
4. 在"**Headers** "列表中添加"KEY"为"Content-Type"，"VALUE"为"application/json"。
   ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001460133253.png)
   
5. 选中"**Body** "的配置项，选中"**raw** "，在空白处添加以下代码。
   图1Token认证鉴权   
   ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001460252921.png)
   图中代码红框内加粗的蓝色字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，\*\*\*\*\*\*\*\*为用户登录密码，project name为服务的部署区域，获取方法请登录[我的凭证](https://console.huaweicloud.com/iam/#/myCredential)获取。
   ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001460292905.png)
   图像识别服务部署的区域必须与调用的服务所在区域一致，本示例中为cn-north-4。
   ```
   {
       "auth": {
           "identity": {
               "methods": [
                   "password"
               ],
               "password": {
                   "user": {
                       "name": "username",
                       "password": "**********",
                       "domain": {
                           "name": "domainname"
                       }
                   }
               }
           },
           "scope": {
               "project": {
                   "name": "cn-north-4"
               }
           }
       }
   }
   ```
   
6. 单击右上角"**Send** "按钮发送请求。获取返回结果中的Token值（Token有效期为24小时）。
   ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001460053065.png)
   
 
 #### 步骤五：调用服务
1. 新建请求，请求方式为修改"**POST** "，按要求填写URL。
   例如服务部署在"华北-北京四"请求URL为https://image.cn-north-4.myhuaweicloud.com/v2.0/image/tagging
   选中"**Headers**"配置项，复制Token值到"X-Auth-Token"。
   登录[我的凭证](https://console.huaweicloud.com/iam/#/myCredential)，查询隶属于"华北-北京四"的项目ID，替换URI中的{project_id}
   ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001409660860.png)
   
2. 单击"Body"配置项，将获取的图片的base64编码填写到"image"参数中。关于body体中其他参数说明，请参考[图像标签API](https://support.huaweicloud.com/api-image/image_03_0025.html)。
   图2修改参数   
   ![](https://support.huaweicloud.com/qs-image/zh-cn_image_0000001410093136.png) 
3. 单击右上角"**Send**"按钮发送请求，查看识别结果。