调用API实现图像标签功能
本章节提供了通过Postman调用Image服务“图像标签”的样例,帮助您零编码快速体验并熟悉本服务,具体流程如下:
步骤一:开通服务,用户在“服务列表”或“服务管理”页面选择图像识别的服务申请开通。
步骤二:对象存储服务OBS授权(可选),如果需要对OBS中的数据进行图像识别,请开通对象存储服务OBS授权。
步骤三:配置环境,获取SDK和样例工程,导入到开发环境中。
步骤四:Token认证鉴权,调用API的时候将Token加到请求消息头,从而通过身份认证获得操作API的权限。
步骤五:调用服务,调用API接口使用服务,使用过程中可以随时查看状态码与错误码。
步骤二:对象存储服务OBS授权(可选)
如果您需要对OBS中的数据进行图像识别,请开通对象存储服务OBS授权。具体操作步骤如下:
- lmage不支持跨区域私有权限的OBS,OBS的区域需要和服务保持一致。
- OBS授权需要使用IAM主账号进行授权,不支持使用子账号进行授权。
- 登录华为云图像识别管理控制台,单击进入“服务管理”页面。
- 打开对象存储服务OBS授权的按钮,完成授权操作。
步骤四:Token认证鉴权
- 在Postman界面,选择“Create”完成创建。
- 选择创建的Collection,单击鼠标右键,选择“Add Request”,设置Request name并单击“Save”。
- 请求方式修改为"POST",输入URL。
例如,以ap-southeast-1为例,URL为“https://iam.ap-southeast-1.myhuaweicloud.com/v3/auth/tokens”。
- 在“Headers”列表中添加“KEY”为“Content-Type”,“VALUE”为“application/json”。
- 选中“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" } } } }
- 单击右上角“Send”按钮发送请求。获取返回结果中的Token值(Token有效期为24小时)。
步骤五:调用服务
- 新建请求,请求方式为修改"POST",按要求填写URL。
例如服务部署在“中国-香港”请求URL为https://image.ap-southeast-1.myhuaweicloud.com/v2.0/image/tagging
选中“Headers”配置项,复制Token值到“X-Auth-Token”。
登录我的凭证,查询隶属于“中国-香港”的项目ID,替换URI中的{project_id}
- 单击“Body”配置项,将获取的图片的base64编码填写到“image”参数中。关于body体中其他参数说明,请参考图像标签API。
图2 修改参数
- 单击右上角“Send”按钮发送请求,查看识别结果。