名人识别-RunCelebrityRecognition
功能介绍
分析并识别图片中包含的敏感人物、明星及网红人物,返回人物信息及人脸坐标。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/image/celebrity-recognition
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 用户的项目ID。获取方法请参见获取项目ID和名称。 约束限制: 不涉及。 取值范围: 只能由英文字母和数字组成,且长度为[1-64]个字符。 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。用于获取操作API的权限。获取方法请参见获取Token接口,响应消息头中X-Subject-Token的值即为Token。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
image |
否 |
String |
参数解释: 与url二选一。 图像数据,base64编码。 约束限制: 不涉及。 取值范围: 要求base64编码后大小不超过10M,最短边至少1px,最长边最大10000px,支持JPEG/PNG/BMP/WEBP格式。 默认取值: 不涉及。 |
|
url |
否 |
String |
参数解释: 与image二选一。 图片的URL路径,目前支持:
约束限制:
取值范围: 不涉及。 默认取值: 不涉及。 |
|
threshold |
否 |
Float |
参数解释: 置信度的阈值(0~1),低于此置信数的标签,将不会返回。 约束限制: 不涉及。 取值范围: 0-1。 默认取值: 0.9。 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
result |
Array of CelebrityRecognitionResultBody objects |
参数解释: 用户Token。用于获取操作API的权限。获取方法请参见获取Token接口,响应消息头中X-Subject-Token的值即为Token。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 调用成功时表示调用结果。 调用失败时无此字段。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
失败响应结果。 |
错误码
请参见错误码。