verification
바운딩 박스로 OCR 결과 검증하기
신뢰도 점수는 모델이 헷갈려 한다는 사실만 알려 주지만, 바운딩 박스는 어디를 봐야 하는지 짚어 줍니다. 필드별 박스와 매치 비율을 활용해 추출한 데이터를 무턱대고 믿는 대신 제대로 검증하는 방법을 정리했습니다.
5 분 분량· 2026-06-25
OCR을 검증한다는 건 보통 문서를 직접 다시 읽는다는 뜻입니다. 느린 데다, 애초에 피하려던 그 일을 그대로 반복하는 셈이죠. 바운딩 박스는 이 흐름을 바꿉니다. 두 줄의 텍스트를 나란히 대조하는 대신, 각 값이 읽혀 온 이미지 속 그 자리로 시선을 바로 옮기면 됩니다. 맞았는지 틀렸는지가 한눈에 드러납니다.
모든 값에 함께 따라오는 두 가지 신호
space-ocr는 각 필드마다 텍스트만 돌려주지 않습니다.
- 바운딩 박스 + 방향 정점(oriented vertices) — 그 값이 어디서 읽혔는지. 박스가 페이지의 엉뚱한 곳에 찍혀 있다면, 값이 그럴듯해 보여도 일단 의심해야 합니다.
match_ratio(0–1) — 그 값의 글자 중 얼마나가 실제로 페이지에서 발견됐는지. 엔진은 0.85 이상을 확신할 수 있는 매치로 간주하며, 그보다 낮은 값들이 곧 직접 눈으로 확인할 필드 목록이 됩니다.
둘을 합치면 검증이 곧 분류 작업(triage)이 됩니다. 매치 비율로 정렬하고, 낮은 것만 들여다보고, 각각을 박스로 확인하면 됩니다.
박스를 믿을 수 있는 이유
박스는 언어 모델이 만들어 낸 것이 아닙니다. 엔진은 추출한 각 값을 비전 OCR이 실제로 페이지에서 감지한 심볼과 글자 단위로 대조합니다 — match_ratio는 그 값의 텍스트가 거기서 얼마나 발견됐는지를 나타내는 수치입니다. (모델이 어떤 단어 토큰을 사용했는지 함께 힌트를 줄 때도, 그 힌트는 그대로 믿는 게 아니라 열·행의 일관성과 교차 검증됩니다.) 따라서 박스는 그 글자들이 페이지에 실제로 존재한다는 증거이지, 값이 있어야 할 자리를 추측해 그려 둔 것이 아닙니다. 전체 논리는 감사 추적이 가능한 문서 OCR 문서를 참고하세요.
- 박스가 포함된 결과 가져오기GET /view를 호출하거나(박스는 기본으로 포함됩니다) POST /ocr/fields를 호출하세요 — 모든 값에 bbox와 match_ratio가 함께 따라옵니다.
- 매치 비율로 정렬하기0.85 미만 필드를 먼저 노출시키세요. 사람이 한 번 봐 줄 가치가 가장 큰 값들입니다.
- 위치로 확인하기표시된 값을 클릭하거나 그 위에 커서를 올려, 원본 이미지에서 정확히 어느 영역에서 읽혔는지 확인하세요.
- 수정하고 넘어가기잘못된 부분은 인라인으로 바로 고치세요. 원래 OCR 값은 기록용으로 그대로 보존됩니다.
바운딩 박스는 OCR 검증에 어떻게 도움이 되나요?
박스는 값이 읽혀 온 정확한 영역을 보여 주므로, 문서 전체를 다시 읽는 대신 그 한 지점만 보고 확인할 수 있습니다. 매치 비율과 함께 쓰면 분류 작업이 가능합니다. 신뢰도가 낮은 필드만 골라 확인하고, 각각을 위치로 검증하면 됩니다.
매치 비율이 얼마면 신뢰할 수 있나요?
space-ocr는 match_ratio가 0.85 이상이면 확신할 수 있는 매치로 봅니다. 1.0이면 값의 모든 글자가 페이지에서 발견됐다는 뜻입니다. 0.85 미만은 검토가 필요한 필드로 다루세요.
검증하려면 OCR을 다시 돌려야 하나요?
아니요. 박스와 매치 비율은 기본 응답에 포함되어 있고, GET /view로 저장된 시트를 조회하는 작업은 OCR을 다시 돌리지도, 크레딧을 차감하지도 않습니다.
관련 글