오류 메시지

CLOVA OCR을 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오.

"API are limited to API calls per domain at the same time." 오류 메시지

"Calls to this api have exceeded the rate limit: API are limited to API calls per domain at the same time." 오류 메시지가 표시됩니다.

원인

CLOVA OCR 모델에서 가능한 동시 요청 수를 초과하였습니다.

해결 방법

CLOVA OCR 모델의 동시 요청 수를 증설해야 하는 경우, 도메인 ID, 월 예상 사용량, 유량 증설 목적을 고객 지원으로 전달해 주십시오.단단, 요청 시점의 가용량에 따라 동시 요청 수 증설이 어려울 수 있습니다.

"NOT_FOUND: not found matched template" 오류 메시지

multiform data로 API 호출 시 "NOT_FOUND: not found matched template" 오류 메시지가 표시됩니다.

원인

• 사용한 이미지가 등록한 템플릿과 매칭되지 않을 경우, 해당 오류가 발생할 수 있습니다.
• 요청 바디에 templateIds를 잘못 지정한 경우, 해당 오류가 발생할 수 있습니다.
• Template OCR에서 사용한 이미지에 일치하는 템플릿을 찾을 수 없는 경우, 해당 오류가 발생할 수 있습니다.

해결 방법

• 요청 바디의 templateIds 값을 확인해 주십시오.
• 이용 중인 템플릿과 호출에 사용한 이미지가 동일한 포맷인지 확인해 주십시오.
• 문제가 지속적으로 발생할 경우, 템플릿에 사용한 이미지, 템플릿 설정 화면, 실제 호출 시 사용한 이미지를 고객 지원으로 전달해 주십시오.

"Not Found Deploy Info: Please confirm the template is released" 오류 메시지

"Not Found Deploy Info: Please confirm the template is released." 오류 메시지가 표시됩니다.

원인

배포가 이루어지지 않았을 때 발생합니다.

해결 방법

Template OCR에서 등록한 템플릿을 이용하려면 화면 좌측 상단의 배포 관리 메뉴에서 등록한 템플릿에 대해 베타 배포와 서비스 배포를 순서대로 배포해야 합니다. 베타 배포를 수행했는지 확인해 주십시오.
자세한 내용은 배포 관리를 참조해 주십시오.

"Recognition failure" 오류 메시지

"Recognition failure" 오류 메시지가 표시됩니다.

원인

이미지 인식에 실패했을 때 나타나는 오류 메시지입니다.

해결 방법

• 호출에 사용한 이미지를 수정해 주십시오. 이미지에 배경이 포함되어 있다면 인식할 부분만 남도록 이미지를 잘라낸 후 다시 호출해 주십시오.
• 문제가 지속될 경우, 호출에 사용한 이미지의 확장자를 txt로 변경하여 고객 지원으로 전달해 주십시오.

"Request invalid: Request data is invalid" 오류 메시지

"Request invalid: Request data is invalid." 오류 메시지가 표시됩니다.

원인

잘못된 요청 바디로 API 호출 시 발생합니다.

해결 방법

• 호출하는 코드를 확인한 후, 요청 바디를 알맞게 수정해 주십시오.
• 네이버 클라우드 플랫폼에서는 코드 리뷰는 지원하지 않으므로, CLOVA OCR API 가이드를 참조하여 API 요청 예시와 사용한 코드 간 차이가 있는지 검토해 주십시오.

"Request invalid. unsupported file format" 오류 메시지

"code": "0011" 오류 메시지가 표시됩니다.
"message": "Request invalid. unsupported file format." 오류 메시지가 표시됩니다.

원인

• 외부 URL인 경우, 이미지 정보를 가져올 수 있는 공개 URL이어야 합니다.
• 필드 값의 형식에 오류가 있을 경우, 발생합니다.

해결 방법

• 외부 URL인 경우, 이미지를 가져올 수 있는 공개 URL인지 확인해 주십시오.
• Content-Type이 application/json인 경우, images 필드로 호출하며 image 필드는 format, name, data로 구성되어 있습니다. data 필드에는 Base64 인코딩된 이미지 데이터를 적용해 주십시오. CLOVA OCR API 가이드에서 제공되는 형식에 맞게 호출해 주십시오.

"Please confirm the template is released" 오류 메시지

"Not Found Deploy Info: Please confirm the template is released" 오류 메시지가 표시됩니다.

원인

템플릿이 베타 배포만 완료되고, 서비스 배포는 완료되지 않은 경우, 발생하는 오류입니다.

해결 방법

서비스 배포를 완료해야 API 호출이 가능합니다. 서비스 배포를 수행해 주십시오.

"Secret validate failed" 오류 메시지

"Secret validate failed" 오류 메시지가 표시됩니다.

원인

입력한 Secret Key가 검증되지 않았을 경우 발생합니다.

해결 방법

• 요청 시 전달된 헤더 정보가 도메인 템플릿 빌더 > [API Gateway 연동] 탭 > [연동] 탭에서 생성한 헤더 정보와 일치하는지 확인해 주십시오.
• 클라이언트 환경 상에서 헤더 정보가 올바르게 전달되고 있는지 확인해 주십시오.
• 응답 상태 코드별 설명은 CLOVA OCR API 가이드을 참조해 주십시오.