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 연동을 간편하게 완료할 수 있습니다. 이 예제에서는 자동 연동 방법을 소개합니다. 자동 연동 방법은 다음과 같습니다.

OCR 빌더에서 Secret Key를 생성하기 위해 [생성] 버튼을 클릭해 주십시오.
image-20191217135217405_ko

API Gateway를 자동으로 연동하기 위해 [자동 연동] 버튼을 클릭해 주십시오.

API Gateway를 사용 중이 아닌 경우 자동 연동 팝업 창이 나타나면 [확인] 버튼을 클릭하여 이용을 신청해 주십시오.
image-20191217135507352_ko

연동이 완료되면 API 호출에 필요한 Secret Key 와 OCR Invoke URL 값을 복사해 주십시오.
image-20191217135557688_ko

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을 확인하는 방법은 다음과 같습니다.

네이버 클라우드 플랫폼 콘솔의 Region 메뉴에서 이용 중인 리전을 클릭하여 선택해 주십시오.

Platform 메뉴에서 VPC와 Classic 가운데 클릭하여 선택해 주십시오.

Services > Application Services > API Gateway 메뉴를 차례대로 클릭해 주십시오.

My Products 메뉴를 클릭해 주십시오.

OCR_CUSTOM_API_KR이라는 Product가 생성되어 있는지 확인해 주십시오.
image-20191217144827615_ko

정상적으로 생성된 경우 API 호출 준비를 완료한 것입니다.

4. Postman으로 API 호출

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

your title goes here

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

Postman에서 새로운 API를 생성하고 호출 방식을 POST로 설정해 주십시오.

Invoke URL 주소에 OCR에서 생성한 API Gateway의 InvokeURL을 입력해 주십시오.
image-20191217171936809_ko

Header 항목에 X-OCR-SECRET 정보를 입력해 주십시오.
image-20191217172419810_ko

Content-Type : application/json
X-OCR-SECRET : {X-OCR-SECRET }

TEXT OCR 호출 BODY를 이미지 인식 요청 BODY의 형식으로 추가해 주십시오.
image-20191217172912524_ko

{
    "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"
}

응답 결과를 확인하기 위해 [SEND] 버튼을 클릭해 주십시오.
image-20191217173003063_ko

응답 결과를 확인해 주십시오.

{
"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"}}
    ]
}

응답 결과를 서비스에 활용해 주십시오.

Text OCR API 호출

1. API 환경 설정

2. API Gateway 자동 연동

3. API Gateway 생성 URL 확인

4. Postman으로 API 호출

What's Next