图像标签（V2）

功能介绍

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

前提条件

使用图像标签服务之前需要您完成服务申请和认证鉴权。

URI

URI格式

POST /v2/{project_id}/image/tagging

请求参数

响应参数

状态码： 200

状态码： 400

请求示例

• “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。

  例如，服务部署在“中国-香港”区域的“endpoint”为“image.ap-southeast-1.myhuaweicloud.com”，请求URL为“https://image.ap-southeast-1.myhuaweicloud.com/v2/{project_id}}/image/tagging”，“project_id”为项目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."
}

状态码

错误码

请参见错误码。