名人识别
功能介绍
分析并识别图片中包含的敏感人物、明星及网红人物，返回人物信息及人脸坐标。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/image/celebrity-recognition
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
用户的项目ID。获取方法请参见获取项目ID和名称。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
image |
否 |
String |
与url二选一 图片文件Base64编码字符串。要求base64编码后大小不超过10M。 检测人脸部分不小于40*40像素。 支持JPEG/PNG/BMP/WEBP格式。 |
url |
否 |
String |
与image二选一。 图片的URL路径，目前支持：
说明：
|
threshold |
否 |
Float |
置信度的阈值（0~1），低于此置信数的标签，将不会返回。 默认值：0.9。 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
result |
Array of CelebrityRecognitionResultBody objects |
调用成功时表示调用结果。 调用失败时无此字段。 |
参数 |
参数类型 |
描述 |
|---|---|---|
confidence |
Float |
置信度，取值范围 0-1。 |
face_detail |
Object |
名人的面部信息，包括4个值： h：人脸区域高度 w：人脸区域宽度 x：人脸区域左上角到y轴距离 y：人脸区域左上角到x轴距离 |
label |
String |
label为对应的名人信息。 |
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 |
error_msg |
String |
调用失败时的错误信息。 调用成功时无此字段。 |
请求示例
- 方式一：使用图片的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 |
失败响应结果。 |
错误码
请参见错误码。
