Text OCR API 호출
    • PDF

    Text OCR API 호출

    • PDF

    기사 요약

    CLOVA OCR 빌더에서 템플릿 등록을 완료 후 테스트 및 서비스 배포가 완료되면 REST API를 사용하여 CLOVA OCR을 이용할 수 있습니다. 여기에서는 TEXT OCR API로 이미지를 입력하고, 인식값을 변환받는 방법과 예제를 안내합니다.

    참고
    • Template OCR도 동일한 방법으로 API 호출이 가능합니다.
    • API 호출에 대한 자세한 내용은 CLOVA OCR API 가이드를 참고해 주십시오.

    TEXT OCR API로 이미지를 입력하고 변환하는 순서와 각 순서별 설명은 다음과 같습니다.

    1. API 환경 설정

    TEXT OCR을 API로 제어하려면 가장 먼저 네이버 클라우드 플랫폼 콘솔의 CLOVA OCR에서 도메인을 생성해야 합니다. OCR 빌더에서 도메인을 생성하면 고유한 InvokeURL이 할당됩니다. InvokeURL은 보안을 위해 외부 서비스에 바로 공개되지 않으며, 보안 및 서비스 처리 수준을 높이기 위해서 API Gateway에 연동하여 사용하도록 설계되어 있습니다.

    2. API Gateway 자동 연동

    InvokeURL을 사용하기 위해 API Gateway를 연동합니다. API Gateway와 연동하는 방법에는 자동과 수동이 있으며, 자동 연동을 선택하면 몇 번의 클릭으로 API Gateway 연동을 간편하게 완료할 수 있습니다. 이 예제에서는 자동 연동 방법을 소개합니다. 자동 연동 방법은 다음과 같습니다.

    1. OCR 빌더에서 Secret Key를 생성하기 위해 [생성] 버튼을 클릭해 주십시오.
      image-20191217135217405_ko(2).png
    2. API Gateway를 자동으로 연동하기 위해 [자동 연동] 버튼을 클릭해 주십시오.
    3. API Gateway를 사용 중이 아닌 경우 자동 연동 팝업 창이 나타나면 [확인] 버튼을 클릭하여 이용을 신청해 주십시오.
      image-20191217135507352_ko(2).png
    4. 연동이 완료되면 API 호출에 필요한 Secret Key 와 OCR Invoke URL 값을 복사해 주십시오.
      image-20191217135557688_ko(2).png
      • Secret Key: {X-OCR-SECRET}
      • OCR Invoke URL: {OCR Invoke URL}

    3. API Gateway 생성 URL 확인

    네이버 클라우드 플랫폼 콘솔의 API Gateway로 이동하여 API Gateway 생성 URL을 확인해야 합니다. OCR_CUSTOM_API_KR이라는 Product가 정상적으로 생성됐다면 API 호출 준비가 완료된 것입니다. API Gateway 생성 URL을 확인하는 방법은 다음과 같습니다.

    1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴에서 이용 중인 리전을 클릭하여 선택해 주십시오.
    2. Platform 메뉴에서 VPCClassic 가운데 클릭하여 선택해 주십시오.
    3. Services > Application Services > API Gateway 메뉴를 차례대로 클릭해 주십시오.
    4. My Products 메뉴를 클릭해 주십시오.
    5. OCR_CUSTOM_API_KR이라는 Product가 생성되어 있는지 확인해 주십시오.
      image-20191217144827615_ko(1).png
      • 정상적으로 생성된 경우 API 호출 준비를 완료한 것입니다.

    4. Postman으로 API 호출

    Text OCR API를 실행할 경우 업로드된 이미지에서 텍스트를 추출할 수 있습니다. 이미지 인식 결과는 json 형식으로 반환되며, 반환된 결과값을 사용자의 서비스에서 활용하면 됩니다. Text OCR API를 호출하는 방법은 다음과 같습니다.

    your title goes here

    Text OCR API 호출에서는 추출 방법을 간단하게 설명하고 있습니다. 자세한 방법이 궁금한 경우 CLOVA OCR API 가이드 를 참고해 주십시오.

    1. Postman에서 새로운 API를 생성하고 호출 방식을 POST로 설정해 주십시오.
    2. Invoke URL 주소에 OCR에서 생성한 API Gateway의 InvokeURL을 입력해 주십시오.
      image-20191217171936809_ko(1).png
    3. Header 항목에 X-OCR-SECRET 정보를 입력해 주십시오.
      image-20191217172419810_ko(1).png
      • Content-Type : application/json
      • X-OCR-SECRET : {X-OCR-SECRET }
    4. TEXT OCR 호출 BODY를 이미지 인식 요청 BODY의 형식으로 추가해 주십시오.
      image-20191217172912524_ko(1).png
      {
          "images": [
            {
              "format": "png",
              "name": "medium",
              "data": null,
              "url": "https://kr.object.ncloudstorage.com/ocr-img/OCR_ko(1)REAN_ko(1).png"
            }
          ],
          "lang": "ko",
          "requestId": "string",
          "resultType": "string",
          "timestamp": {{$timestamp}},
          "version": "V1"
      }
      
    5. 응답 결과를 확인하기 위해 [SEND] 버튼을 클릭해 주십시오.
      image-20191217173003063_ko(1).png
    6. 응답 결과를 확인해 주십시오.
      {
      "version":"V1",
      "requestId":"string",
      "timestamp":1576569034247,
      "images":[
        {
          "uid":"9fd73a6aacad4025b3099a36ee55aacd",
          "name":"medium","inferResult":"SUCCESS","message":"SUCCESS",
          "fields":[
              {"inferText":"나","inferConfidence":0.9967288},
              {"inferText":"하늘로","inferConfidence":0.9998919},
              {"inferText":"돌아가리라","inferConfidence":0.9999104},
              {"inferText":"아름다운","inferConfidence":0.99992156},
              {"inferText":"이","inferConfidence":0.99958915},
              {"inferText":"세상","inferConfidence":0.9998707},
              {"inferText":"소풍","inferConfidence":0.9988277},
              {"inferText":"끝내는","inferConfidence":0.9999253},
              {"inferText":"날","inferConfidence":0.99908936},
              {"inferText":"가서","inferConfidence":0.99974936},
              {"inferText":"아름다웠더라고","inferConfidence":0.9997728},
              {"inferText":"말하리라","inferConfidence":0.9993808}
              ],
          "validationResult":{"result":"NO_REQUESTED"}}
          ]
      }
      
    7. 응답 결과를 서비스에 활용해 주십시오.

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.