接口描述

用于檢測輸入圖像中的人臉是否戴口罩。

請求方法

POST

接口要求

• 圖片大小限制：圖片單張大小小于2MB。
• 圖片格式限制：圖片格式支持jpg/jpeg/png/bmp格式。

URI

/v1/aiop/api/2f6hycj3a9z4/face/PERSON/person/detectMaskFromBase64

請求參數

1.請求頭header參數

2.請求體body參數

請求代碼示例

Curl -X POST "//ai-global.ctapi.daliqc.cn/v1/aiop/api/2f6hycj3a9z4/face/PERSON/person/detectMaskFromBase64"
-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.daliqc.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
            },
            "Mask" : false
        }]
    }
}

2.請求失敗返回值示例

{
 'code': 4101, 'message': '請求內容錯誤',
 'details': '傳入內容為空，或者傳入的參數名錯誤',
 'statusCode': 4101, 'error': 'AI_OP_4101'
}

狀態碼

錯誤碼說明

4 位錯誤碼，4 開頭為業務錯誤碼，5 開頭為服務錯誤碼。

base64 編碼規則：使用常規的 safe base64 編碼方式

• python 中推薦使用 base64.urlsafe_b64encode() 函數進行編碼。
• java 中推薦使用 BASE64.getUrlEncoder().encodeToString() 函數進行編碼。