--- title: "오류 메시지" slug: "clovaocr-troubleshoot-error" tags: ["CLOVA OCR", "템플릿 배포"] updated: 2026-05-21T09:01:21Z published: 2026-05-21T09:03:03Z canonical: "guide-gov.ncloud-docs.com/clovaocr-troubleshoot-error" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 오류 메시지 Classic/VPC 환경에서 이용 가능합니다. 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, 월 예상 사용량, 유량 증설 목적을 [고객 지원](https://www.gov-ncloud.com/support/question/service)으로 전달해 주십시오. 다만, 요청 시점의 가용량에 따라 동시 요청 수 증설이 어려울 수 있습니다. ## "NOT_FOUND: not found matched template" 오류 메시지 multiform data로 API 호출 시 "NOT_FOUND: not found matched template" 오류 메시지가 표시됩니다. #### 원인 - 사용한 이미지가 등록한 템플릿과 매칭되지 않을 경우, 해당 오류가 발생할 수 있습니다. - 요청 바디에 templateIds를 잘못 지정한 경우, 해당 오류가 발생할 수 있습니다. - Template OCR에서 사용한 이미지에 일치하는 템플릿을 찾을 수 없는 경우, 해당 오류가 발생할 수 있습니다. #### 해결 방법 - 요청 바디의 templateIds 값을 확인해 주십시오. - 이용 중인 템플릿과 호출에 사용한 이미지가 동일한 포맷인지 확인해 주십시오. - 문제가 지속적으로 발생할 경우, 템플릿에 사용한 이미지, 템플릿 설정 화면, 실제 호출 시 사용한 이미지를 [고객 지원](https://www.gov-ncloud.com/support/question/service)으로 전달해 주십시오. ## "Not Found Deploy Info: Please confirm the template is released" 오류 메시지 "Not Found Deploy Info: Please confirm the template is released." 오류 메시지가 표시됩니다. #### 원인 배포가 이루어지지 않았을 때 발생합니다. #### 해결 방법 Template OCR에서 등록한 템플릿을 이용하려면 화면 좌측 상단의 **배포 관리** 메뉴에서 등록한 템플릿에 대해 베타 배포와 서비스 배포를 순서대로 배포해야 합니다. 베타 배포를 수행했는지 확인해 주십시오. 자세한 내용은 [배포 관리](/docs/clovaocr-template#%EB%B0%B0%ED%8F%AC%EA%B4%80%EB%A6%AC)를 참조해 주십시오. ## "Recognition failure" 오류 메시지 "Recognition failure" 오류 메시지가 표시됩니다. #### 원인 이미지 인식에 실패했을 때 나타나는 오류 메시지입니다. #### 해결 방법 - 호출에 사용한 이미지를 수정해 주십시오. 이미지에 배경이 포함되어 있다면 인식할 부분만 남도록 이미지를 잘라낸 후 다시 호출해 주십시오. - 문제가 지속될 경우, 호출에 사용한 이미지의 확장자를 txt로 변경하여 [고객 지원](https://www.gov-ncloud.com/support/question/service)으로 전달해 주십시오. ## "Request invalid: Request data is invalid" 오류 메시지 "Request invalid: Request data is invalid." 오류 메시지가 표시됩니다. #### 원인 잘못된 요청 바디로 API 호출 시 발생합니다. #### 해결 방법 - 호출하는 코드를 확인한 후, 요청 바디를 알맞게 수정해 주십시오. - 네이버 클라우드 플랫폼에서는 코드 리뷰는 지원하지 않으므로, [CLOVA OCR API 가이드](https://api-gov.ncloud-docs.com/docs/ai-application-service-ocr-ocr#%EC%9A%94%EC%B2%AD%EC%98%88%EC%8B%9C)를 참조하여 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 가이드](https://api-gov.ncloud-docs.com/docs/ai-application-service-ocr-ocrdocumentocr#%EC%9A%94%EC%B2%AD-%EB%B0%94%EB%94%94)에서 제공되는 형식에 맞게 호출해 주십시오. ## "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 가이드](https://api-gov.ncloud-docs.com/docs/ai-application-service-ocr#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오. 참고 이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.