Twinreader API 사용하기 1

아티클 관련 제품: Twinreader2.0

들어가며

• Twinreader API를 호출하여 분석 결과를 받는 방법에 대해 알아봅니다.

API 사용 디스크 정보

• API 호출에 사용하는 4개의 디렉토리 디스크 정보를 활용합니다.

  디렉토리	설명
  input	Twinreader에 요청된 이미지의 저장 경로
  convert	input에 저장된 요청 이미지를 png 로 인코딩하여 저장하는 경로
  output	요청 이미지에 대한 Twinreader 분석 결과를 저장하는 경로
  extension/	Twinreader의 확장 기능 실행을 위한 js 파일 저장하는 경로

API 호출 결과 디렉토리 정보

• 호출을 통해 나온 분석 결과 정보들은 아래 디렉토리에서 확인 가능합니다.

  디렉토리	파일	용도
  chkdetection	<파일명>.png	체크박스 인식 이미지
  	<파일명>.txt	체크박스 인식 결과
  classification	<파일명>.txt	모델 문서 분류 결과
  detectionResult	<파일명>.png	STD 모델(이미지에서 문자 탐색) 이미지
  	<파일명>.txt	STD 모델(이미지에서 문자 탐색) 결과
  iddetection	<파일명>txt	신분증 인식 결과
  json	<파일명>_combined.json	chkdetection(체크박스), detectionResult+out(문자인식), iddetection(신분증인식), tcdetection(셀인식) 4가지 결과가 모두 들어간 모델의 최종 결과 파일
  original	<파일명>.png	원본 이미지 파일을 png로 변환한 파일
  out	<파일명>txt	STR 모델(탐색문자의 내용 인지) 결과
  preprocessing	<파일명>.png	rotation 모델(기울어진 이미지 보정) 이미지
  tcdetection	<파일명>.png	셀 인식 이미지
  	<파일명>.txt	셀 인식 결과
  templateJson	<파일명>_refine_ocr_result.json	모델 결과값을 사용한 중간 산출물
  	<파일명>_template_result.json	최종 결과물

  
  

API List 정보

• 분석에 이용되는 API 리스트는 아래와 같습니다.

  API	설명
  이미지분석 요청ID 사용	이미지를 png로 변환 후 요청 ID를 통한 callback 처리 가능한 분석 요청 API
  분석 문서 분류 조회	문서 분류 명 조회 API
  분석 상태 체크 조회	이미지 진행과정에 대한 진행 상태체크 API
  DB 정보 삭제	이미지 분석 정보 삭제 API
  template 결과 추출 요청	분석 데이터를 지정한 템플릿으로 결과를 추출하는 API
  template 결과요청	단일 건에 대한 template 결과 데이터 API
  detection 결과요청	단일 건에 대한 detection 원시 데이터 API
  template 이전 정제데이터 요청	단일 건에 대한 template 이전 정제 데이터 API

  
  

마무리

• API를 사용하기 전 디렉토리와 리스트 정보에 대해 알아보았습니다.
• 다음 단계로 Twinreader API 사용하기 2를 참고해주시기 바랍니다.