개발가이드

  • 개발가이드

이미지 얼굴 인식

이미지 파일에서 얼굴을 인식해 해당 좌표를 추출합니다.

업로드 용량 제한: 50MB
multipart/form-data 요청에 포함된 첨부 이미지 합계는 최대 50MB입니다.
제한을 초과하면 HTTP 413과 REQUEST_TOO_LARGE 오류가 반환되며 과금되지 않습니다.

결과 예시

[이미지]
[동영상]

정보

Method
URL
POST
https://apick.app/rest/face_detection

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
image
File
O
이미지 파일
threshold
Double
X
얼굴추출 민감도
0 ~ 0.9 (기본값 0.5, 높을 수록 정확한 얼굴만 추출)

응답

Body
이름
타입
설명
data
Object
조회 데이터
result
Array
추출된 얼굴 리스트
{}
Object
얼굴 정보
landmark
Array
경계(왼쪽눈, 오른쪽눈, 코, 왼쪽 입꼬리, 오른쪽 입꼬리 순서)
[]
Array
경계의 x 좌표, y 좌표
det_score
Double
얼굴 탐지 정확도
(0~1, 1에 가까울수록 정확)
height
Integer
높이
width
Integer
너비
face_crop
Array
얼굴 크롭 좌표(시작 좌표, 끝 좌표)
[]
Array
x 좌표, y 좌표
success
Integer
과금 여부
0: 실패
1: 성공
3: 실패(timeout)
api
Object
API 호출 공통 데이터
success
Boolean
API 서버 정상 응답 여부
cost
Integer
API 호출 요금
ms
Integer
API 응답 시간
pl_id
Integer
API 결제 로그 ID

예시

요청 예시

curl -k -X POST "https://apick.app/rest/face_detection" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "image=@/C:/Users/user/Desktop/sample_img.png"
응답 예시

{
    "data": {
        "result": [
            {
                "landmark": [
                    [
                        429.3706970214844,
                        280.9442138671875
                    ],
                    [
                        458.5393371582031,
                        280.26409912109375
                    ],
                    [
                        443.2686462402344,
                        295.4951171875
                    ],
                    [
                        433.3480224609375,
                        311.8315124511719
                    ],
                    [
                        455.7586669921875,
                        311.30450439453125
                    ]
                ],
                "height": 472,
                "width": 742,
                "det_score": 0.8643505573272705,
                "face_crop": [
                    [
                        424.3706970214844,
                        275.26409912109375
                    ],
                    [
                        463.5393371582031,
                        316.8315124511719
                    ]
                ]
            }
        ],
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 3,
        "ms": 475,
        "pl_id": 108609
    }
}
현재 페이지 북마크