한국어 문서를
대량으로 읽는
OCR API
사업자등록증, 영수증, 계약서, 신분증, 표, 손글씨까지. 이미지 한 장을 보내면 줄 단위 텍스트와 좌표, 신뢰도를 JSON으로 돌려드려요. 지금 이 페이지에서 실제 API를 바로 호출해 볼 수 있어요.
내 문서로 바로 확인해 보세요
견본을 고르거나 이미지를 끌어다 놓으면 운영 중인 API가 실제로 읽어요. 읽은 줄마다 위치를 이미지 위에 표시해요. 줄에 마우스를 올리면 그 위치가 강조돼요.
{ }코드 그대로, 실제 요청을 보내 보세요
언어를 고르면 연동 코드가 나오고, «요청 보내기»를 누르면 같은 요청이 데모 API로 나가요(키 없이 쓰는 체험용이에요. 운영 API 주소는 /api/ocr/v1/ocr이고 키가 필요해요). 돌아온 응답 원문과 걸린 시간을 그대로 보여드려요.
// «요청 보내기»를 누르면 실제 응답이 여기에 나와요.
연동에 필요한 것만, 빠짐없이
텍스트만 주고 끝나지 않아요. 화면에 표시하고, 검수하고, 다른 시스템으로 넘기는 데 필요한 정보까지 한 번에 받으세요.
줄 단위 결과
문서를 읽는 순서대로 줄을 나눠 돌려드려요. 화면 표시나 검수 목록에 그대로 쓸 수 있어요.
좌표와 다각형
줄마다 사각형 좌표와 네 꼭짓점을 함께 줘요. 원본 위에 강조하거나 특정 영역만 잘라 쓰기 쉬워요.
줄별 신뢰도
0~1 사이 값으로 줘요. 기준보다 낮은 줄만 사람이 다시 보게 하면 검수 시간을 줄일 수 있어요.
방향·기울기 보정
휴대폰으로 비스듬히 찍거나 뒤집힌 사진도 줄 방향을 먼저 판단한 뒤 읽어요.
주민번호 자동 가림
주민등록번호 뒤 7자리는 응답에 넣기 전에 서버에서 가려요. 끄는 옵션은 두지 않았어요.
대량 처리 대기열
요청이 몰리면 대기열에서 순서대로 처리해요. 바쁠 때는 429로 알려 드려 재시도 로직을 짜기 쉬워요.
한 장이 JSON이 되기까지
보낸 이미지는 아래 여섯 단계를 거쳐요. 모든 단계가 메모리 안에서 끝나고, 원본은 어디에도 파일로 남지 않아요.
수신
HTTPS로 받은 이미지를 디스크에 쓰지 않고 메모리 대기열에 올려요.
방향 판단
줄이 뒤집혔거나 돌아갔는지 먼저 판단해 바로잡아요.
글자 영역 검출
글자가 있는 영역을 찾고, 기울어진 줄은 회전된 상자로 잡아요.
한국어 인식
한국어 전용 인식 모델이 줄마다 글자와 신뢰도를 뽑아요.
정렬·가림
읽는 순서로 줄을 정렬하고 주민번호 뒤 7자리를 가려요.
JSON 응답
텍스트, 줄, 좌표, 신뢰도, 처리 시간을 담아 돌려드리고 메모리에서 지워요.
사람이 옮겨 적던 일을 API 한 번으로
매달 같은 서류를 손으로 입력하고 있다면 바로 맞는 곳이에요.
세무·회계 사무소
고객사가 보낸 영수증·세금계산서 사진에서 날짜와 금액 줄을 뽑아 장부 입력을 줄여요.
- 영수증
- 세금계산서
- 카드 전표
B2B 가입·입점 심사
사업자등록증 사진에서 등록번호·상호·대표자를 읽어 가입 폼을 미리 채워요.
- 사업자등록증
- 통장 사본
계약서 전산화
쌓인 종이 계약서를 스캔해 검색되는 텍스트로 바꾸고, 줄 좌표로 원문 위치를 찾아가요.
- 계약서
- 약정서
- 합의서
물류·유통 명세서
거래명세서와 송장의 표를 줄 단위로 읽어 품목과 수량을 시스템으로 넘겨요.
- 거래명세서
- 송장
- 발주서
본인 확인 서류 접수
신분증 사본을 받는 곳에서 주민번호 뒷자리는 자동으로 가린 텍스트만 저장해요.
- 신분증 사본
- 가족관계 서류
손으로 쓴 신청서
현장에서 받은 손글씨 신청서·설문지를 텍스트로 바꿔 사람은 낮은 신뢰도 줄만 확인해요.
- 신청서
- 설문지
- 메모
엔드포인트 하나, 외울 것이 없어요
이미지 바이너리를 본문에 담아 보내면 돼요. 멀티파트도, SDK도 필요 없어요.
/api/ocr/v1/ocr| 항목 | 내용 |
|---|---|
| 주소 | https://kryft.io/api/ocr/v1/ocr |
| 인증 | Authorization: Bearer plut_ocr_live_…키는 /ocr/pricing/에서 이메일 확인으로 바로 받아요(매달 100쪽 무료). 이 페이지 콘솔은 데모 전용이라 키 없이 동작해요. |
| 본문 | multipart file 또는 이미지·PDF 바이너리(JPG·PNG·WEBP·TIFF·PDF), doc_type로 문서 종류 지정 |
| 크기 상한 | 파일 10MB, PDF 20쪽, 키당 초당 2건 |
| 응답 | application/json · 줄·좌표·표·문서별 필드 JSON(전체 문서) |
| 상태 확인 | GET /api/ocr/v1/health · 사용량 GET /api/ocr/v1/usage |
401 invalid_key | 키가 없거나 맞지 않아요 |
402 no_credit | 무료 한도와 크레딧을 다 썼어요(결제 주소를 함께 돌려줘요) |
413 file_too_large | 10MB를 넘었어요 |
422 unsupported_format | 읽을 수 없는 형식이에요. 차감하지 않아요 |
429 rate_limited | 요청이 많아요. 잠시 뒤 다시 보내요 |
503 engine_unavailable | 엔진 연결이 늦어요. 차감하지 않아요 |
| 필드 | 설명 |
|---|---|
text | 읽은 전체 텍스트(줄바꿈 포함) |
lines[] | 줄 목록. 읽는 순서대로 |
lines[].text | 그 줄의 글자 |
lines[].box | [x1, y1, x2, y2] 사각형 좌표(픽셀) |
lines[].polygon | 네 꼭짓점 좌표. 기울어진 줄에 써요 |
lines[].confidence | 0~1 신뢰도 |
width, height | 처리한 이미지 크기 |
masked | 주민번호를 가렸는지 |
ms | 엔진 처리 시간(ms) |
total_ms | 대기 포함 전체 시간(ms) |
model | 사용한 인식 모델 이름 |
민감한 서류일수록 남기지 않아요
OCR에 들어오는 문서는 대부분 개인정보예요. 그래서 처음부터 «저장하지 않는 구조»로 만들었어요.
원본을 파일로 쓰지 않아요
이미지는 메모리에서만 처리하고 응답을 보낸 뒤 바로 지워요. 서버 디스크와 DB에 원본이 남지 않아요.
접속 기록에 본문이 없어요
OCR 경로는 웹 서버 접속 기록을 남기지 않게 설정했어요. 결과 텍스트도 따로 쌓지 않아요.
주민번호는 항상 가려요
뒤 7자리는 응답을 만들기 전에 가려요. 이 동작은 끌 수 없어요.
HTTPS 전 구간 암호화
요청과 응답은 모두 HTTPS로 오가요. 설치형이 필요하면 문서가 회사 밖으로 나가지 않게 구성해 드려요.
문의부터 운영까지 다섯 단계
먼저 우리 문서로 얼마나 잘 읽는지 확인하고 나서 결정하세요. 확인 단계는 비용이 들지 않아요.
도입 상담
문서 종류, 월 예상 쪽수, 연동 방식을 알려 주세요. 아래 양식이나 메일로 받아요.
무료견본 정확도 확인
실제 문서 견본(개인정보는 가린 사본)으로 읽어 보고, 결과를 표로 정리해 드려요.
무료견적·할인 확정
물량과 계약 기간에 맞춰 표준 단가에서 할인한 견적을 드려요.
물량별 할인키 발급·연동
/ocr/pricing/에서 이메일 확인으로 키를 바로 받아요. 별도 계약 고객은 연동 일정을 함께 맞춰요.
연동 지원 포함운영·정산
쓴 쪽수만큼 차감하거나 월 단위로 정산해요. 사용량은 요청하면 언제든 보내 드려요.
사용량 기준표준 단가
한 장(이미지 1개 또는 PDF 1페이지)을 1쪽으로 세요. 키를 받으면 매달 100쪽은 무료이고, 그 뒤로는 크레딧을 사서 써요. 월 5만 쪽이 넘으면 별도 견적을 드려요.
이 페이지의 데모와 콘솔로 실제 API를 바로 시험해 볼 수 있어요.
도입을 검토 중이면 견본 정확도 확인을 무료로 해 드려요.
월 5만 쪽이 넘거나, 설치형이 필요하면
물량, 계약 기간, 설치 방식에 맞춰 표준 단가보다 낮은 별도 단가로 견적을 드려요.
표시 금액은 부가세 포함이에요. 구간 단가를 쪽수에 곱한 표준가 계산이며, 월 5만 쪽이 넘는 견적은 상담 후 확정해요.
도입 전에 많이 물어요
여러 쪽짜리 PDF도 되나요?
지금 API는 이미지 한 장 단위로 받아요. PDF는 쪽마다 이미지로 바꿔 보내 주시면 되고, PDF를 그대로 받는 방식이 필요하면 도입 상담 때 말씀해 주세요.
쪽수는 어떻게 세나요?
요청 한 번에 보낸 이미지 1개를 1쪽으로 세요. 오류로 끝난 요청(4xx·5xx)은 세지 않아요.
보낸 문서가 학습에 쓰이나요?
아니요. 원본 이미지는 메모리에서 처리한 뒤 바로 지우고 파일로 남기지 않아서 학습에 쓸 수 없어요. 고객 문서에 맞춘 학습이 필요하면 별도 동의를 받아 따로 진행해요.
정확도는 얼마나 되나요?
문서 상태와 종류에 따라 크게 달라서 하나의 숫자로 약속하지 않아요. 대신 도입 2단계에서 실제 문서 견본으로 읽어 보고 결과를 표로 드려요. 이 페이지 데모로도 바로 확인할 수 있어요. 합성 평가셋 기준 자체 측정 결과는 공개 측정표에 원자료와 함께 있어요.
할인은 얼마나 되나요?
월 물량, 약정 기간, 설치 방식에 따라 달라요. 상담 양식에 월 예상 쪽수를 적어 주시면 그 기준으로 견적을 드려요.
세금계산서를 받을 수 있나요?
네. 팀플럿(주) 명의로 발행해 드려요.
엔진이 멈추면 어떻게 되나요?
503 engine_offline을 돌려드려요. 재시도 간격을 두고 다시 보내 주시면 되고, 상태는 GET /ocr/api/health로 확인할 수 있어요.
문서 견본 한 장이면
시작할 수 있어요
양식을 채우고 보내기를 누르면 메일 앱이 열려요. 내용을 확인하고 보내 주시면 hello@teamplut.com에서 답장드려요.
- 01문서 종류와 월 예상 쪽수를 보고 맞는 구간과 할인안을 정리해요.
- 02견본 정확도 확인 방법을 안내해요(개인정보는 가린 사본으로).
- 03견적과 연동 일정을 함께 드려요.
월 5만 쪽이 넘거나 설치형이 필요하면 아래 양식으로 견적을 받아요.