更新时间:2023-08-03 gmt 08:00

图像标签(v2)-凯发k8国际娱乐官网入口

功能介绍

自然图像的语义内容非常丰富,一个图像包含多个标签内容,图像标签服务准确识别自然图片中数百种场景、上千种通用物体及其属性,让智能相册管理、照片检索和分类、基于场景内容或者物体的广告推荐等功能更加直观。使用时用户发送待处理图片,返回图像标签内容及相应置信度。

前提条件

  • 使用图像标签服务之前需要您完成和。
  • 图像识别服务属于公有云服务,线上用户资源共享,如果需要多并发请求,请提前。

调试

您可以在中调试该接口,支持自动认证鉴权。api explorer可以自动生成sdk代码示例,并提供sdk代码示例调试功能。

uri

uri格式

post /v2/{project_id}/image/tagging

表1 路径参数

参数

是否必选

参数类型

描述

project_id

string

用户的项目id。获取方法请参见。

请求参数

表2 请求header参数

参数

是否必选

参数类型

描述

x-auth-token

string

用户token。

用于获取操作api的权限。获取方法请参见,响应消息头中x-subject-token的值即为token。

表3 请求body参数

参数

是否必选

参数类型

描述

image

string

与url二选一。

图像数据,base64编码,要求base64编码后大小不超过10m,最短边至少1px,最长边最大4096px,支持jpeg/png/bmp/webp格式。

url

string

与image二选一。

图片的url路径,目前支持:

  • 公网http/https url
  • obs提供的url,使用obs数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详情参见。
说明:
  • 接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。
  • 请保证被检测图片所在的存储服务稳定可靠,推荐使用obs服务存储图片数据。
  • lmage不支持跨区域obs,obs的区域需要和服务保持一致。

language

string

zh:返回标签的语言类型为中文。

en:返回标签的语言类型为英文。

默认值为zh。

threshold

float

置信度的阈值(0~100),低于此置信数的标签,将不会返回。

默认值:60

最小值:0

最大值:100

limit

integer

最多返回的tag数(取值范围:1-150)。

响应参数

状态码: 200

表4 响应body参数

参数

参数类型

描述

result

result object

调用成功时为图像标签内容。

调用失败时无此字段。

表5 result

参数

参数类型

描述

tags

array of imagetaggingitembody objects

标签列表集合。

表6 imagetaggingitembody

参数

参数类型

描述

confidence

string

置信度,将float型置信度转为string类型返回,取值范围:0-100。

type

string

标签的类别。有以下三种类别:

object:实体标签

scene:场景标签

concept:概念标签

tag

string

标签名称。

i18n_tag

i18n_tag object

标签的多种语言输出。

i18n_type

i18n_type object

标签类别的多种语言输出。

instances

array of imagetagginginstance objects

目标检测框信息,为空则表示没有目标检测框。

表7 i18n_tag

参数

参数类型

描述

zh

string

中文标签。

en

string

英文标签。

表8 i18n_type

参数

参数类型

描述

zh

string

中文标签类别。

en

string

英文标签类别。

表9 imagetagginginstance

参数

参数类型

描述

bounding_box

boundingboxfloat object

目标检测框位置信息。

confidence

string

检测标签置信度,将float型置信度转为string类型返回,float取值范围(0~100)。

表10 boundingboxfloat

参数

参数类型

描述

width

double

检测框区域宽度。

height

double

检测框区域高度。

top_left_x

double

检测框左上角到垂直轴距离。

top_left_y

double

检测框左上角到水平轴距离。

状态码: 400

表11 响应body参数

参数

参数类型

描述

error_code

string

调用失败时的错误码,具体请参见。

调用成功时无此字段。

error_msg

string

调用失败时的错误信息。

调用成功时无此字段。

请求示例

  • “endpoint”即调用api的请求地址,不同服务不同区域的“endpoint”不同,具体请参见。

    例如,服务部署在“华北-北京四”区域的“endpoint”“image.cn-north-4.myhuaweicloud.com”,请求url为“https://image.cn-north-4.myhuaweicloud.com/v2/{project_id}}/image/tagging”“project_id”为项目id,获取方法请参见。

  • 方式一:使用图片的base64编码,对待处理图片返回图像标签内容及相应置信度,返回标签的语言类型为中文,置信度的阈值为70。
    post https://{endpoint}/v2/{project_id}/image/tagging
    {
      "image" : "/9j/4aaqskzjrgabageasabiaad/4rfzrxhpzgaatu0akgaaaagabwesaamaaaabaaeaaaeaaauaaaabaaaaygebaa...",
      "url" : "",
      "language" : "zh",
      "limit" : 5,
      "threshold" : 70.0
    }
  • 方式二:使用图片url,对待处理图片返回图像标签内容及相应置信度,返回标签的语言类型为中文,置信度的阈值为70。
    post https://{endpoint}/v2/{project_id}/image/tagging
    {
      "image" : "",
      "url" : "https://bucketname.obs.myhuaweicloud.com/objectname",
      "language" : "zh",
      "limit" : 5,
      "threshold" : 70.0
    }

响应示例

状态码: 200

成功响应结果

{
  "result" : {
    "tags" : [ {
      "confidence" : "37.51",
      "instances" : [ {
        "confidence" : "92.38",
        "bounding_box" : {
          "height" : 133.32496056189905,
          "top_left_x" : 53.134917332575874,
          "top_left_y" : 254.21347984900842,
          "width" : 117.5866567171537
        }
      } ],
      "tag" : "人",
      "i18n_tag" : {
        "en" : "person",
        "zh" : "人"
      },
      "type" : "人类",
      "i18n_type" : {
        "en" : "human",
        "zh" : "人类"
      }
    } ]
  }
}

状态码: 400

失败响应结果

{
  "error_code" : "ais.0005",
  "error_msg" : "the service does not exist."
}

状态码

状态码

描述

200

成功响应结果。

400

失败响应结果。

错误码

请参见。

分享:
网站地图