space ocr
가이드아티클요금문서
Image OCR

텍스트 더미가 아니라 구조화 필드를 돌려주는 이미지 OCR

space-ocr로 JPEG·PNG 등 이미지를 OCR하세요. 내장 템플릿, 품목, CSV/JSON 내보내기, 그리고 모든 값이 이미지 내 박스와 일치 점수와 함께 반환됩니다.

대부분의 이미지 OCR은 평범한 텍스트 덩어리를 던져주고 거기서 멈춥니다. 영수증을 찍어 돌려도 돌아오는 건 줄들의 묶음이라, 결국 읽고, 나누고, 맞는 열에 다시 입력하게 됩니다. 페이지에서는 눈에 한눈에 들어오던 구조가 사라져 버리죠.

space-ocr는 이미지를 구조화 필드로 읽어냅니다 — 상호는 여기, 날짜는 저기, 합계는 저쪽, 품목은 행으로. 그리고 모든 값을 이미지에서 읽어낸 정확한 위치와 함께 돌려줍니다. 눈으로 보이는 박스와, 픽셀에 얼마나 일치했는지를 나타내는 점수까지요. 그래서 추출 결과를 그냥 믿을 필요 없이, 사진을 보고 직접 확인할 수 있습니다.

직접 검증할 수 있는 실제 추출 결과

이건 한 장의 이미지 — 영수증 두 개를 찍은 사진 — 를 필드로 읽은 것입니다. 아래 어느 값이든 마우스를 올리면, 이미지 위의 박스가 그 값을 읽어낸 지점입니다. 여기 있는 숫자·박스·일치 점수는 모두 실제 파싱 결과에서 읽어온 것으로, 목업이 아닙니다.

Receipts with extracted-field bounding boxes
Verified fields
KINSHO · 合計 2,045
ライフ · 合計 4,286

Each value with a box carries a verified on-page location — bbox + 4-point vertices + match_ratio — on a 0–1000 normalized grid (0,0 top-left → 1000,1000 bottom-right), the same shape the live API returns. Hover a field to trace it back to the pixels it came from.

텍스트 더미가 아니라 구조화 필드
이미지는 상호·날짜·합계·품목 같은 이름 붙은 필드와 행으로 돌아옵니다 — 직접 잘라야 하는 긴 한 줄짜리 문자열이 아닙니다.
모든 값에 위치 정보
각 필드는 바운딩 박스(0–1000 그리드의 xmin/ymin/xmax/ymax), 방향이 있는 네 꼭짓점, match_ratio를 반환합니다 — 값이 이미지 내 정확한 위치까지 추적됩니다.
휴대폰 사진도 OK
로드 시 EXIF 회전을 적용해 반환 좌표가 화면에 보이는 이미지와 일치합니다. 방향이 있는 박스는 손으로 찍은 사진의 기울기도 따라갑니다.
내장 템플릿
영수증·세금계산서·납품서·명함·운전면허증 템플릿을 templateId 하나로 적용하거나, 직접 필드를 정의하세요.
합계만이 아니라 품목까지
표는 셀별 위치를 가진 반복 행으로 돌아옵니다. 빽빽한 이미지에서 줄바꿈되거나 병합된 행도 추적 가능합니다.
깔끔한 내보내기
UTF-8 BOM CSV(Excel·한중일 안전, 품목 펼침)와 비동기 작업·서명 웹훅을 갖춘 REST API의 JSON.

space-ocr의 이미지 OCR 작동 방식

이미지를 URL 또는 순수 base64로 /ocr/fields에 보냅니다 — JPEG·PNG·GIF·BMP·TIFF·WebP가 그대로 읽힙니다. 로드 시 EXIF orientation을 적용하므로, 돌아오는 박스는 표시되는 사진과 일치합니다. 휴대폰을 비스듬히 들고 찍은 사진도 마찬가지입니다.

흔한 문서라면 스키마를 작성할 필요가 없습니다. receiptinvoice 같은 내장 templateId를 넘기거나, 직접 fields를 정의하세요 — 품목에는 children을 가진 array 필드를 포함합니다. (PDF는 웹 앱을 거쳐 각 페이지를 먼저 이미지로 렌더링합니다. API 자체는 이미지를 읽습니다.)

이미지에서 필드 추출
1
2
3
4
5
6
7
8
curl -s https://api.space-ocr.com/ocr/fields \
  -H "Authorization: Bearer $SPACE_OCR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://example.com/receipt-photo.jpg",
    "imageType": "url",
    "templateId": "receipt"
  }'

이미지를 OCR하는 방법

  1. 이미지 보내기
    JPEG·PNG·GIF·BMP·TIFF·WebP를 /ocr/fields에 URL 또는 순수 base64로 보내거나, 앱에 끌어다 놓습니다. 로드 시 EXIF 회전이 적용됩니다.
  2. 템플릿 또는 필드 선택
    'receipt'나 'invoice' 같은 내장 templateId를 넘기거나, 직접 fields를 지정합니다 — 품목 표에는 children이 있는 array 필드를 포함합니다.
  3. 구조화 결과 읽기
    각 값은 bbox·vertices·match_ratio·bbox_source와 함께 반환되며, 이미지 내 모든 필드 위치를 담은 field_bboxes 맵도 제공됩니다.
  4. 무엇이든 검증
    값을 클릭하면 그 값을 읽어낸 정확한 영역이 강조됩니다. match_ratio가 0.85 미만이면 한 번 더 살펴볼 값입니다. 수정 사항은 원본 OCR 값 옆에 저장됩니다.
  5. 내보내기 또는 조회
    CSV(UTF-8 BOM, 품목 펼쳐짐)를 다운로드하거나, 저장된 시트를 GET /view로 where·sort·select를 써서 조회합니다 — OCR 재실행도 추가 비용도 없습니다.

단순하고 예측 가능한 가격

이미지당 ₩100(¥10 / $0.05), 신용카드 없이 월 100회 스캔 무료 플랜 포함. 정액 플랜은 월 스캔 수·시트·저장공간을 추가합니다.

Free
₩0
  • 100 스캔/월
  • 3 시트
  • 1 GB 저장공간
무료 — 카드 불필요
Starter
₩29,800/월
  • 400 스캔/월
  • 10 시트
  • 10 GB 저장공간
무료로 시작
가장 인기
Pro
₩69,800/월
  • 1,100 스캔/월
  • 시트 무제한
  • 100 GB 저장공간
무료로 시작
space-ocr는 어떤 이미지 포맷을 OCR할 수 있나요?
공개 API는 래스터 이미지를 그대로 읽습니다 — JPEG·PNG·GIF·BMP·TIFF·WebP. 이미지는 자동으로 RGB로 변환됩니다. PDF는 웹 앱을 거쳐 각 페이지를 이미지로 렌더링한 뒤 OCR합니다.
이미지 OCR은 구조화 필드를 주나요, 아니면 그냥 텍스트인가요?
구조화 필드입니다. 이미지는 상호·날짜·합계·품목 같은 이름 붙은 값과 행으로 읽히며, 각각이 위치 정보를 가집니다 — 직접 파싱해야 하는 긴 텍스트 덩어리가 아닙니다.
휴대폰으로 찍은 사진도 OCR할 수 있나요?
네. 로드 시 EXIF orientation을 적용하므로 반환 좌표가 표시되는 사진과 일치하고, 방향이 있는 바운딩 박스는 손으로 찍은 사진의 기울기를 따라갑니다. 살짝 비뚤어진 사진도 깔끔하게 맞습니다.
이미지 OCR이 각 값의 위치를 보존하나요?
네. 각 값은 바운딩 박스(0–1000 정규화 그리드의 xmin/ymin/xmax/ymax), 방향이 있는 네 꼭짓점, match_ratio와 함께 반환됩니다. match_ratio가 0.85 이상이면 확실한 매칭으로 보고, 1.0은 모든 글자를 이미지에서 찾았다는 뜻입니다.
이미지는 API에 어떻게 보내나요?
POST /ocr/fields에 URL(imageType 'url') 또는 순수 base64(imageType 'base64', data-URI 접두사 없음)로 보냅니다. 인증은 Bearer 토큰이며 키는 spocr_로 시작합니다. 내장 templateId나 직접 정의한 fields를 넘깁니다.
이미지 OCR 비용은 얼마인가요?
이미지당 $0.05(¥10 / ₩100)이며, 신용카드 없이 월 100회 스캔 무료 플랜이 있습니다. 정액 플랜(Starter·Pro)은 월 스캔 수·시트·저장공간을 추가합니다 — 위 요금표를 참고하세요.

내 이미지를 직접 확인 가능한 데이터로

무료 플랜 — 월 100회 스캔, 신용카드 불필요. 모든 값이 이미지 내 위치와 함께 돌아옵니다.

관련