文档首页 > > API参考> API>

名人识别

名人识别

分享
更新时间:2021/02/25 GMT+08:00

功能介绍

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

前提条件

  • 在使用名人识别服务之前需要您完成服务申请认证鉴权
  • 名人识别默认API调用最大并发为5,如需调整更高并发限制请联系华为专业工程师为您服务。

URI

URI格式

POST /v1.0/image/celebrity-recognition

请求消息

请求参数请参见表1
表1 请求参数说明

名称

是否必选

类型

说明

image

false

String

与url二选一

图片文件Base64编码字符串。要求base64编码后大小不超过10M。

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

支持JPG/PNG/BMP格式。

url

false

String

与image二选一。

图片的URL路径,目前支持:

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

threshold

false

float

置信度的阈值(0~1),输入非该范围内值算法即取默认值。

默认值:0.48。

响应消息

响应参数请参见表2
表2 响应参数说明

名称

类型

说明

result

Array

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

调用失败时无此字段。

confidence

Number

置信度,取值范围(0~1)。

face_detail

Object

politics场景中的人脸坐标信息,包括4个值。

h:人脸区域高度

w:人脸区域宽度

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

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

label

String

label为对应的名人信息。

error_code

String

调用失败时的错误码,具体请参见错误码

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

  • 请求示例(方式一:使用图片的BASE64编码)
    POST https://image.cn-north-1.myhuaweicloud.com/v1.0/image/celebrity-recognition
       
    Request Header:  
    Content-Type:application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
    
    Request Body:
    {
     "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj...",
      "url": "",
      "threshold": ""
    }  
  • 请求示例(方式二:使用图片URL)
    POST https://image.cn-north-1.myhuaweicloud.com/v1.0/image/celebrity-recognition
       
    Request Header:  
    Content-Type:application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
    
    Request Body:
    {
      "image":"",
      "url":"https://<bucketName>.obs.<region>.myhuaweicloud.com/<objectName>",
      "threshold": ""
    } 
  • 成功响应示例
    {
       "result": [{
             "confidence": 0.44977834820747375,
             "face_detail": {
                "h": 280,
                "w": 186,
                "x": 163,
                "y": 117
             },
             "label": "xxx"
          }
       ]
    }
  • 失败响应示例
    {
        "error_code": "AIS.0014",
        "error_msg": "The JSON format of the input data is incorrect."
    }

返回值

  • 正常

    200

  • 失败

    返回值

    说明

    400

    • 语义有误,当前请求无法被服务器解析。除非进行修改,否则客户端不应重复提交这个请求。
    • 请求参数有误。

    401

    当前请求需要用户验证。

    403

    没有操作权限。

    404

    请求失败,在服务器上未找到请求所希望得到的资源。

    500

    服务器遇到了一个未曾预料的状况,导致无法完成对请求的处理。

错误码

错误码请参见 错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问
{{site}}{{lan}}
{{site}}{{language}}