标签识别

功能介绍

对用户传入的图像可以返回图像中的物体名称、所属类别及置信度信息。

前提条件

• 使用标签识别服务之前需要您完成服务申请和认证鉴权。
• 图像识别服务属于公有云服务，线上用户资源共享，如果需要多并发请求，请提前联系我们。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v2/{project_id}/image/media-tagging

请求参数

响应参数

状态码： 200

状态码： 400

请求示例

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

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

• 方式一：使用图片的BASE64编码，对于用户传入的图像返回图像中的物体名称、所属类别及置信度信息，返回标签的语言类型为中文，最多返回的标签数为5。

  POST https://{endpoint}/v2/{project_id}/image/media-tagging
  
  {
    "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...",
    "url" : "",
    "language" : "zh",
    "limit" : 5,
    "threshold" : 20
  }

• 方式二：使用图片URL，对于用户传入的图像返回图像中的物体名称、所属类别及置信度信息，返回标签的语言类型为中文，最多返回的标签数为5。

  POST https://{endpoint}/v2/{project_id}/image/media-tagging
  
  {
    "image" : "",
    "url" : "https://support.huaweicloud.com/productdesc-image/zh-cn_image_0000001382844041.jpg",   //此处更改为您需要识别的图片URL
    "language" : "zh",
    "limit" : 5,
    "threshold" : 20
  }

响应示例

状态码： 200

成功响应结果

{
 "result": {
  "tags": [
   {
    "confidence": "39.42",
    "i18n_tag": {
     "en": "Picnic",
     "zh": "野餐"
    },
    "i18n_type": {
     "en": "Food",
     "zh": "食物"
    },
    "instances": [],
    "tag": "野餐",
    "type": "食物"
   },
   {
    "confidence": "30.19",
    "i18n_tag": {
     "en": "Miniature projector",
     "zh": "微型投影仪"
    },
    "i18n_type": {
     "en": "Electronics",
     "zh": "电子类"
    },
    "instances": [],
    "tag": "微型投影仪",
    "type": "电子类"
   },
   {
    "confidence": "24.93",
    "i18n_tag": {
     "en": "Picnic Basket",
     "zh": "野餐篮"
    },
    "i18n_type": {
     "en": "Home category",
     "zh": "家居类"
    },
    "instances": [],
    "tag": "野餐篮",
    "type": "家居类"
   },
   {
    "confidence": "21.58",
    "i18n_tag": {
     "en": "Harmonica",
     "zh": "口琴"
    },
    "i18n_type": {
     "en": "Culture and art",
     "zh": "文化艺术类"
    },
    "instances": [],
    "tag": "口琴",
    "type": "文化艺术类"
   }
  ]
 }
}

状态码： 400

失败响应结果

{
  "error_code" : "AIS.0005",
  "error_msg" : "The service does not exist."
}

状态码

错误码

请参见错误码。