文档首页/ 图像识别 Image/ 快速入门/ 调用API实现图像标签功能
更新时间:2024-04-18 GMT+08:00

调用API实现图像标签功能

本章节提供了通过Postman调用Image服务“图像标签”的样例,帮助您零编码快速体验并熟悉本服务,具体流程如下:

步骤一:开通服务,用户在“服务列表”“服务管理”页面选择图像识别的服务申请开通。

步骤二:对象存储服务OBS授权(可选),如果需要对OBS中的数据进行图像识别,请开通对象存储服务OBS授权。

步骤三:配置环境,获取SDK和样例工程,导入到开发环境中。

步骤四:Token认证鉴权,调用API的时候将Token加到请求消息头,从而通过身份认证获得操作API的权限。

步骤五:调用服务,调用API接口使用服务,使用过程中可以随时查看状态码与错误码。

步骤一:开通服务

图像识别服务申请开通您可以按照以下步骤进行操作:

  1. 登录华为云,申请华为账号,并完成实名认证。
  2. 华为云页面顶部选择产品>人工智能>图像识别 Image
  3. 进入产品页,单击立即使用,输入您注册的用户名密码,进入图像识别管理控制台。
  4. 用户可以在图像识别管理控制台“服务列表”“服务管理”页面申请开通服务。

    以在“服务管理”页面开通“图像识别-图像标签”服务为例,在“商用服务”栏中选择“图像标签”,单击“开通服务”开通。

    • 服务只需要开通一次即可,后面使用时无需再申请。

  5. 商用服务申请成功后,在“服务管理”页面,“我的服务”中显示已经申请开通成功的服务,此时,您可以通过调用API接口的方式使用图像识别服务。

步骤二:对象存储服务OBS授权(可选)

如果您需要对OBS中的数据进行图像识别,请开通对象存储服务OBS授权。具体操作步骤如下:

  1. lmage不支持跨区域私有权限的OBS,OBS的区域需要和服务保持一致。
  2. OBS授权需要使用IAM主账号进行授权,不支持使用子账号进行授权。
  1. 登录华为云图像识别管理控制台,单击进入“服务管理”页面。
  2. 打开对象存储服务OBS授权的按钮,完成授权操作。

步骤三:配置环境

下载并安装Postman。Postman建议使用7.24.0版本。

步骤四:Token认证鉴权

  1. 在Postman界面,选择New > Collection,设置相应的名称并单击“Create”完成创建。

  2. 选择创建的Collection,单击鼠标右键,选择“Add Request”,设置Request name并单击“Save”

  3. 请求方式修改为"POST",输入URL。

    例如,以ap-southeast-1为例,URL为“https://iam.ap-southeast-1.myhuaweicloud.com/v3/auth/tokens”

  4. 在“Headers”列表中添加“KEY”“Content-Type”“VALUE”“application/json”

  5. 选中“Body”的配置项,选中“raw”,在空白处添加以下代码。
    图1 Token认证鉴权

    图中代码红框内加粗的蓝色字段需要根据实际值填写,其中username为用户名,domainname为用户所属的账号名称,********为用户登录密码,project name为服务的部署区域,获取方法请登录我的凭证获取。

    图像识别服务部署的区域必须与调用的服务所在区域一致,本示例中为ap-southeast-1。

    {
        "auth": {
            "identity": {
                "methods": [
                    "password"
                ],
                "password": {
                    "user": {
                        "name": "username",
                        "password": "**********",
                        "domain": {
                            "name": "domainname"
                        }
                    }
                }
            },
            "scope": {
                "project": {
                    "name": "ap-southeast-1"
                }
            }
        }
    }
  6. 单击右上角“Send”按钮发送请求。获取返回结果中的Token值(Token有效期为24小时)。

步骤五:调用服务

  1. 新建请求,请求方式为修改"POST",按要求填写URL。

    例如服务部署在“中国-香港”请求URL为https://image.ap-southeast-1.myhuaweicloud.com/v2.0/image/tagging

    选中“Headers”配置项,复制Token值到“X-Auth-Token”

    登录我的凭证,查询隶属于“中国-香港”的项目ID,替换URI中的{project_id}

  2. 单击“Body”配置项,将获取的图片的base64编码填写到“image”参数中。关于body体中其他参数说明,请参考图像标签API
    图2 修改参数
  3. 单击右上角“Send”按钮发送请求,查看识别结果。