接口描述

用于检测输入图像中的人脸年龄、性别等属性。

请求方法

POST

接口要求

• 图片大小限制：图片单张大小小于2MB。
• 图片格式限制：图片格式支持jpg/jpeg/png/bmp格式。

URI

/v1/aiop/api/2f6hw5o5t7gg/face/PERSON/person/detectAgeGenderFromBase64

请求参数

1.请求头header参数

2.请求体body参数

请求代码示例

Curl -X POST "https://ai-global.ctapi.ctyun.cn/v1/aiop/api/2f6hw5o5t7gg/face/PERSON/person/detectAgeGenderFromBase64"
-H "Content-Type: application/json"
-H "ctyun-eop-request-id:33dfa732-b27b-464f-b15a-21ed6845afd5"
-H "appkey:XXX"
-H "Eop-Authorization:XXX"
-H "eop-date:20211109T104641Z"
-H "host:ai-global.ctapi.ctyun.cn"
--data '{"imageContent":"AAAAAAAAA...."}'

返回值说明

1.请求成功返回响应参数

2.表returnObj

3.请求失败返回响应参数

返回值示例

1.请求成功返回值示例

{
    "statusCode": "0",
    "message": "success",
    "returnObj":{
        "face_num" : 1,
        "face_list" : [{
            "face_location" : {
                "top" : 36,
                "left" : 48,
                "width" : 58,
                "height" : 72
            },
            "gender" : "Male",
            "age" : "23"
        }]
    }
}

2.请求失败返回值示例

{
    "statusCode": "4101",
    "message": "error",
    "details": "请求内容错误"
    "error":"AI_OP_4101"
}

状态码

错误码说明

4 位错误码，4 开头为业务错误码，5 开头为服务错误码。

base64 编码规则：使用常规的 safe base64 编码方式

• python 中推荐使用 base64.urlsafe_b64encode() 函数进行编码。
• java 中推荐使用 BASE64.getUrlEncoder().encodeToString() 函数进行编码。