检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
》> 认证鉴权 > AK/SK认证。 调用API 图像识别以API的方式提供服务,具体操作请参见《图像识别API参考》。 查看服务使用信息 您可以在图像识别控制台查看服务调用总次数。
image和url参数二选一),示例中以url为例,配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点,详情请查看地区和终端节点。 媒资图像标签调用示例代码如下: # coding: utf-8 from huaweicloudsdkcore.auth
状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 表1 响应消息头 名称 描述 Content-Length
准备环境 在使用图像识别SDK时,各语言需要准备的环境 参照表1。 表1 开发环境 开发语言 准备项 说明 JAVA 安装JDK JAVA环境开发配置,支持 Java JDK 1.8 及以上版本,推荐通过Maven 安装依赖的方式使用JAVA版本SDK。 PYTHON 安装python
介绍使用Image SDK在本地进行开发,用户直接调用接口函数即可使用SDK功能。 本地调用 查看调用次数 调用结果统计 开始使用服务后,可以在管理控制台上查看服务使用详情和调用次数统计。 查看调用次数
在“创建用户组”界面,输入“用户组名称”单击“确定”。 用户组创建完成之后,界面自动返回用户组列表,列表中显示新建的用户组。 进行全局服务配置,单击新建用户组右侧的“权限配置”,在“权限管理”页签中,单击列表左上方的“授权”。此处作用范围选择“全局服务”。勾选需要授予用户组的权限“Tenant
在页面右上角单击用户名,然后在下拉列表中单击“我的凭证”,进入“我的凭证”页面。 如果您登录的是华为云官网,而非管理控制台。在单击用户名后,选择下拉列表中的“账号中心”,然后单击“管理我的凭证”进入“我的凭证”页面。 在“API凭证”页面的项目列表中查看项目ID和名称(即“项目”)。 图1 查看项目ID
请求消息 请求参数说明请参见表1。 表1 请求参数说明 名称 是否必选 类型 说明 url 是 String 视频的URL路径,目前支持华为云上OBS提供的临时授权访问的URL。 目前支持的视频仅限mp4格式,最大65MB。 响应消息 响参数说明请参见表2。 表2 响应参数说明 名称 类型
择“访问密钥 > 新增访问密钥”获取。 图4 新增访问密钥 运行示例代码,获取识别结果,如图5所示。 图5 运行示例 查看调用次数。您可以在控制台的“概览”页查看调用总次数图6所示。 图6 调用统计
本章节提供了通过Postman调用Image服务“图像标签”的样例,帮助您零编码快速体验并熟悉本服务,具体流程如下: 步骤一:开通服务,用户在“服务列表”或“服务管理”页面选择图像识别的服务申请开通。 步骤二:对象存储服务OBS授权(可选),如果需要对OBS中的数据进行图像识别,请开通对象存储服务OBS授权。
服务所支持的区域是指服务部署在该区域下的服务器,用户所在地区与服务部署区域不一致也是可以开通和使用本服务的。有如下两种情况: 如果请求输入的数据是OBS地址方式,就需要使用相同区域的图像识别服务。 例如:您的OBS请求数据在“华北-北京四”,只能调用“华北-北京四”区域下的图像识别服务,如果本服务不支持该区域则不能调用。
API概览 图像识别服务所提供的API为自研API。通过使用图像识别服务的自研API,您可以完整的使用图像识别服务的如表1所示功能。 表1 接口说明 API 说明 媒资图像标签(分类)-标签识别 标签识别服务使用时,用户发送待处理图片,返回图像标签内容及相应置信度。 媒资图像标签(检测)
默认值:0.9。 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 result Array of CelebrityRecognitionResultBody objects 调用成功时表示调用结果。 调用失败时无此字段。 表5 CelebrityRecognitionResultBody
默认值:30,最小值:0,最大值:100。 响应参数 状态码: 200 表4 result 参数 参数类型 描述 result Array of ImageMainObjectDetectionInstance objects 主体列表集合。 表5 ImageMainObjectDetectionInstance
功能说明 本节定义了图像识别上报云监控的监控指标的命名空间,监控指标列表和维度定义,用户可以通过云监控服务提供管理控制台和云监控提供的API接口来检索图像识别产生的监控指标。 命名空间 SYS.IRS 监控指标 表1 服务支持的监控指标 指标ID 指标名称 指标含义 取值范围 监控周期(原始指标)
ImageMediaTaggingDetInstance objects 目标检测框信息,为空则表示没有目标检测框。 表7 i18n_tag 参数 参数类型 描述 zh String 中文标签。 en String 英文标签。 表8 ImageMediaTaggingDetInstance 参数 参数类型
目标检测框信息,为空则表示没有目标检测框。 表7 i18n_tag 参数 参数类型 描述 zh String 中文标签。 en String 英文标签。 表8 i18n_type 参数 参数类型 描述 zh String 中文标签类别。 en String 英文标签类别。 表9 ImageTaggingInstance
4204", "error_msg":"Request api error! The API is not subscribed." } 表明您还未订阅该区域下的图像识别服务,请您开通后再使用该服务。 注意核对您开通本服务的区域,如开通“华北-北京四”下的图像标签功能,则您在“华
保留该字段,可忽略)。 表7 i18n_tag 参数 参数类型 描述 zh String 中文标签。 en String 英文标签。 表8 i18n_type 参数 参数类型 描述 zh String 中文标签类别。 en String 英文标签类别。 表9 ImageMediaTaggingInstance
验。 2021年8月 序号 功能名称 功能描述 阶段 相关文档 1 新版SDK文档上线 新版SDK可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档,参照进行进阶配置。同时增加了更多开发代码的示例。 商用 SDK参考 2021年7月 序号 功能名称 功能描述 阶段