
# 调用SDK实现功能
图像搜索服务软件开发工具包（ImageSearch SDK）是对图像搜索服务提供的REST API进行的封装，以简化用户的开发工作。
本章节以搜索数据接口为例，介绍如何使用ImageSearch Java SDK在本地开发，用户调用接口函数即可使用SDK功能。其他接口功能及支持的SDK可参考[图像搜索SDK参考](https://support.huaweicloud.com/sdkreference-imagesearch/imagesearch_03_0001.html)。
#### 准备工作
已注册华为账号，并完成实名认证，账号不能处于欠费或冻结状态。
#### 开通服务
服务申请开通您可以按照以下步骤进行操作：
1. 登录华为云图像搜索服务管理控制台。 控制台左上角默认显示服务部署在"华北-北京四"区域，请您根据业务需要选择对应区域，各服务部署的区域具体请参见[终端节点](https://support.huaweicloud.com/api-imagesearch/imagesearch_02_0032.html)。
   
2. 单击页面右上角的"开通服务"按钮，开通图像搜索服务。
   图1开通服务   
   ![](https://support.huaweicloud.com/qs-imagesearch/zh-cn_image_0000001683019249.png "点击放大") 
![](https://support.huaweicloud.com/qs-imagesearch/public_sys-resources/note_3.0-zh-cn.png)
- 服务只需要开通一次即可，后面使用时无需再开通。
- 整体开通图像搜索服务后，具体的搜索服务实例需要单独创建。
 
#### 调用SDK
1. 安装Python环境并获取SDK软件包。
   1. 从[Python官网](https://www.python.org/)下载并安装合适的Python版本。请使用Python3.3以上版本，如下以Python3.7 版本为例进行说明。
   
   2. 从[PyCharm官网](https://www.jetbrains.com/pycharm/)下载并安装最新版本。
   
   3. 在PyCharm开发工具中配置Python环境，在菜单依次选择"File \> Settings \> Project Interpreter"。
   
   4. 在页面上方选择您的Python安装路径，如图PyCharm配置python环境所示。选择好目标Python之后单击页面下方"Apply"完成配置。
   
   
   图2PyCharm配置python环境   
   ![](https://support.huaweicloud.com/qs-imagesearch/zh-cn_image_0000001645245014.png "点击放大") 
2. 在PyCharm中新建一个项目，并单击左下方"Terminal"按钮。分别执行以下命令安装SDK（该SDK支持Python3及以上版本）。参考方法如下：
   ```
   pip 安装：
   # 安装核心库
   pip install huaweicloudsdkcore
    
   # 安装ImageSearch服务库
   pip install huaweicloudsdkimagesearch
   ```
   在pycharm中，选择"File \> Settings \> Project \> Python Interpreter"单击右上角+，分别搜索huaweicloudsdkcore及huaweicloudsdkimagesearch，搜索到包内容单击左下角Install Package完成安装。
   图3pycharm安装图像搜索python版本sdk包   
   ![](https://support.huaweicloud.com/qs-imagesearch/zh-cn_image_0000001645247314.png "点击放大") 
3. 获取图像搜索搜索接口SDK示例代码。
   1. 登录API Explorer，在"代码示例"中选择"Python"。
      图4APIE   
      ![](https://support.huaweicloud.com/qs-imagesearch/zh-cn_image_0000001645088274.png "点击放大") 
   
   2. 填写参数：service_name（实例名称）、search_type（搜索类型）和image_url（图片路径）。 例如：service_name输入general_image_test，search_type输入IMAGE，image_url输入https://image_url.com。
      图5填写参数   
      ![](https://support.huaweicloud.com/qs-imagesearch/zh-cn_image_0000001693408373.png "点击放大") 
   
   3. 复制代码至Pycharm中。
    
4. 获取AK/SK，替换代码示例中的"\<YOUR AK\>"、"\<YOUR SK\>"参数。 登录[访问密钥](https://console.huaweicloud.com/iam/?region=cn-north-4#/mine/accessKey)页面，新增访问密钥，或使用已有的访问密钥。访问密钥为credentials.csv文件，包含AK/SK信息。
   图6获取AK/SK   
   ![](https://support.huaweicloud.com/qs-imagesearch/zh-cn_image_0000001645089162.png) 
5. 运行代码示例，获取搜索结果。
   图7获取结果   
   ![](https://support.huaweicloud.com/qs-imagesearch/zh-cn_image_0000001645089230.png "点击放大") 
 
