CLOVA Face Recognition(CFR)
참고
네이버 클라우드 플랫폼의 상품 사용 방법을 보다 상세하게 제공하고, 다양한 API의 활용을 돕기 위해 [설명서]와 [API 참조서]를 구분하여 제공하고 있습니다.
CLOVA Face Recognition API 참조서 바로가기 >>
CLOVA Face Recognition 설명서 바로가기 >>
개요
입력된 비전 데이터를 통해 얼굴을 인식하거나 얼굴 감지를 이용한 애플리케이션을 만들 때 유용한 API 서비스입니다. 이미지 속의 얼굴과 가장 닮은 유명인을 찾거나, 얼굴의 윤곽과 눈/코/입 위치, 표정 값을 얻을 수 있습니다.
공통 설정
클라이언트 아이디는 네이버 클라우드 플랫폼 콘솔에서 애플리케이션을 등록해 발급받습니다.
콘솔의 AI·Application Service > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >
AI·Application Service > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.
AI·Application Service > AI·NAVER API > Application의 변경 화면에서 CLOVA Face Recognition가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.
API URL
// 유명인 얼굴 인식 API
https://naveropenapi.apigw.gov-ntruss.com/vision/v1/celebrity
// 얼굴 감지 API
https://naveropenapi.apigw.gov-ntruss.com/vision/v1/face
요청 헤더
헤더 명 | 설명 |
---|---|
X-NCP-APIGW-API-KEY-ID | 앱 등록 시 발급받은 Client IDX-NCP-APIGW-API-KEY-ID:{Client ID} |
X-NCP-APIGW-API-KEY | 앱 등록 시 발급 받은 Client SecretX-NCP-APIGW-API-KEY:{Client Secret} |
Content-Type | 바이너리 전송 형식Content-Type: multipart/form-data |
에러 코드
공통 에러
{
"error": {
"errorCode": "300",
"message": "Not Found Exception"
}
}
HttpStatusCode | ErrorCode | ErrorMessage | Description |
---|---|---|---|
400 | 100 | Bad Request Exception | protocol(https), endocing(UTF-8) 등 request 에러 |
401 | 200 | Authentication Failed | 인증실패 |
401 | 210 | Permission Denied | 권한없음 |
404 | 300 | Not Found Exception | 권한없음 |
429 | 400 | Quota Exceeded | Quota 초과 |
429 | 410 | Throttle Limited | Rate 초과 |
429 | 420 | Rate Limited | Rate 초과 |
413 | 430 | Request Entity Too Large | conent-length 초과 (10MB) |
503 | 500 | Endpoint Error | 엔드포인트 연결에러 |
504 | 510 | Endpoint Timeout | 엔드포인트 연결시간 초과 |
500 | 900 | Unexpected Error | 예외처리가 안된 에러 |
API 에러
HttpStatusCode | ErrorCode | ErrorMessage | Description |
---|---|---|---|
400 | ER01 | image parameter is needed. | image 파라미터가 누락되었습니다. |
400 | ER02 | Failed to receive image content. | 이미지 데이터를 수신하는데 실패했습니다. |
400 | ER03 | Bad reqeust. | 잘못된 요청을 수신했습니다. |
400 | ER04 | Image size is too large. | 이미지의 크기가 2MB를 넘었습니다. |
400 | ER11 | Abnormal image format. | 인식할 수 없는 이미지 데이터가 입력되었습니다. |
400 | ER12 | Abnormal image width v.s height ratio. | 이미지의 너비가 높이의 4 배 이상입니다. |
400 | ER13 | Image width is to small. | 이미지의 너비가 50 픽셀보다 작습니다. |
400 | ER14 | Image height is too small. | 이미지의 높이가 50 픽셀보다 작습니다. |
400 | ER15 | Failed to analyze image. | 분석할 수 없는 이미지가 입력되었습니다. |
400 | ER21 | Timeout error. | 서버에서 이미지 분석을 시간 내에 처리하지 못했습니다. |
400 | ER22 | Server is too busy. | 현재 이미지 분석 요청이 많아 처리할 수 없습니다. |
500 | ER92 | Failed to generate valid json string. | 서버에서 유효한 형식의 JSON 데이터를 결과로 생성하지 못했습니다. |
500 | ER99 | Internal server error. | 내부 서버 오류입니다. 포럼에 문의하시면 신속히 조치하겠습니다. |