媒资图像标签（检测）

功能介绍

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

与媒资图像标签（分类）相比，媒资图像标签（检测）还能返回图像的坐标位置。

前提条件

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

调试

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

URI

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

请求参数

响应参数

状态码： 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-det”，“project_id”为项目ID，获取方法请参见获取项目ID和名称。

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

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

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

  POST https://{endpoint}/v2/{project_id}/image/media-tagging-det
  
  {
    "image" : "",
    "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName",
    "language" : "en",
    "limit" : 5,
    "threshold" : 40
  }

响应示例

状态码： 200

成功响应结果

{
  "result" : {
    "tags" : [ {
      "confidence" : "75.74",
      "instances" : [ {
        "confidence" : "75.74",
        "bounding_box" : {
          "height" : 453,
          "top_left_x" : 513,
          "top_left_y" : 764,
          "width" : 123
        }
      } ],
      "i18n_tag" : {
        "en" : "tie",
        "zh" : "领带"
      },
      "tag" : "领带",
      "type" : "服饰穿戴类"
    } ]
  }
}

状态码： 400

失败响应结果

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

状态码

错误码

请参见错误码。