凯发k8国际娱乐官网入口-k8凯发> 图像识别 image> > > 名人识别
更新时间：2023-08-03 gmt 08:00

名人识别-凯发k8国际娱乐官网入口

功能介绍

分析并识别图片中包含的敏感人物、明星及网红人物，返回人物信息及人脸坐标。

前提条件

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

调试

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

uri

post /v2/{project_id}/image/celebrity-recognition

表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。

检测人脸部分不小于40*40像素。

支持jpeg/png/bmp/webp格式。

url

否

string

与image二选一。

图片的url路径，目前支持：

  • 公网http/https url
  • 华为云obs提供的url，使用obs数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详情参见。
说明：
  • 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。
  • 请保证被检测图片所在的存储服务稳定可靠，建议您使用华为云obs存储。

threshold

否

float

置信度的阈值（0~1），低于此置信数的标签，将不会返回。

默认值：0.48。

响应参数

状态码： 200

表4 响应body参数

参数

参数类型

描述

result

array of celebrityrecognitionresultbody objects

调用成功时表示调用结果。

调用失败时无此字段。
表5 celebrityrecognitionresultbody

参数

参数类型

描述

confidence

float

置信度，取值范围 0-1。

face_detail

object

名人的面部信息，包括4个值：

h：人脸区域高度

w：人脸区域宽度

x：人脸区域左上角到y轴距离

y：人脸区域左上角到x轴距离

label

string

label为对应的名人信息。

状态码： 400

表6 响应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/celebrity-recognition”，“project_id”为项目id，获取方法请参见。

  • 方式一：使用图片的base64编码，识别图中人物，返回人物信息及人脸坐标，置信度的阈值为0.48。
    post https://{endpoint}/v2/{project_id}/image/celebrity-recognition
{
  "image" : "/9j/4aaqskzjrgabageasabiaad/4rfzrxhpzgaatu0akgaaaagabwesaamaaaabaaeaaaeaaauaaaabaaaaygebaa...",
  "url" : "",
  "threshold" : 0.48
}
  • 方式二：使用图片url，识别图中人物，返回人物信息及人脸坐标，置信度的阈值为0.48。
    post https://{endpoint}/v2/{project_id}/image/celebrity-recognition
{
  "image" : "",
  "url" : "https://bucketname.obs.myhuaweicloud.com/objectname",
  "threshold" : 0.48
}

响应示例

状态码： 200

成功响应结果

{
  "result" : [ {
    "confidence" : 0.44977834820747375,
    "face_detail" : {
      "h" : 280,
      "w" : 186,
      "x" : 163,
      "y" : 117
    },
    "label" : "xxx"
  } ]
}

状态码： 400

失败响应结果

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

状态码

状态码

描述

200

成功响应结果。

400

失败响应结果。

错误码

请参见。

父主题：
分享：
网站地图