更新时间:2024-03-12 GMT+08:00
分享

名人识别

功能介绍

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

前提条件

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

调试

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

用户的项目ID。获取方法请参见获取项目ID和名称

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

用于获取操作API的权限。获取方法请参见获取Token接口,响应消息头中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服务的访问权限
说明:
  • 接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。
  • 请保证被检测图片所在的存储服务稳定可靠,建议您使用华为云OBS存储。

threshold

Float

置信度的阈值(0~1),低于此置信数的标签,将不会返回。

默认值:0.9。

响应参数

状态码: 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,获取方法请参见获取项目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

失败响应结果。

错误码

请参见错误码

相关文档