主体识别-凯发k8国际娱乐官网入口

功能介绍

用户传入图片通过后台算法判断图片主体，并返回主体坐标。

前提条件

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

调试

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

uri

post /v3/{project_id}/image/main-object-detection

请求参数

响应参数

状态码： 200

状态码： 400

请求示例

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

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

• 方式一：使用图片的base64编码，判断图片主体并返回主体坐标，置信度的阈值为30。

  post https://{endpoint}/v3/{project_id}image/main-object-detection
  {
    "image" : "/9j/4aaqskzjrgabageasabiaad/4rfzrxhpzgaatu0akgaaaagabwesaamaaaabaaeaaaeaaauaaaabaaaaygebaa...",
    "url" : "",
    "threshold" : 30
  }

• 方式二：使用图片url，判断图片主体并返回主体坐标，置信度的阈值为30。

  post https://{endpoint}/v3/{project_id}image/main-object-detection
  {
    "image" : "",
    "url" : "https://bucketname.obs.myhuaweicloud.com/objectname",
    "threshold" : 30
  }

响应示例

状态码： 200

成功响应结果

{
  "result" : [ {
    "label" : "bounding_box",
    "location" : {
      "height" : 133.32,
      "top_left_x" : 53.13,
      "top_left_y" : 254.21,
      "width" : 117.58
    },
    "confidence" : "92.38"
  }, {
    "label" : "main_object_box",
    "location" : {
      "height" : 261.32,
      "top_left_x" : 256.13,
      "top_left_y" : 85.21,
      "width" : 139.58
    },
    "confidence" : "66.38"
  } ]
}

状态码： 400

失败响应结果

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

状态码

错误码

请参见。