Clova Face Recognition(CFR)

참고

네이버 클라우드 플랫폼의 상품 사용 방법을 보다 상세하게 제공하고, 다양한 API의 활용을 돕기 위해 [설명서]와 [API 참조서]를 구분하여 제공하고 있습니다.

Clova Face Recognition API 참조서 바로가기 >>
Clova Face Recognition 설명서 바로가기 >>

개요

입력된 비전 데이터를 통해 얼굴을 인식하거나 얼굴 감지를 이용한 애플리케이션을 만들 때 유용한 API 서비스입니다. 이미지 속의 얼굴과 가장 닮은 유명인을 찾거나, 얼굴의 윤곽과 눈/코/입 위치, 표정 값을 얻을 수 있습니다.

공통 설정

클라이언트 아이디는 네이버 클라우드 플랫폼 콘솔에서 애플리케이션을 등록해 발급받습니다.

  1. 콘솔의 AI·Application Service > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >

  2. AI·Application Service > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.

  3. 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 ID
X-NCP-APIGW-API-KEY-ID:{Client ID}
X-NCP-APIGW-API-KEY 앱 등록 시 발급 받은 Client Secret
X-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. 내부 서버 오류입니다. 포럼에 문의하시면 신속히 조치하겠습니다.

오퍼레이션