여권·신분증 OCR API – HTTP 호출 한 번, 문서 1건당 1¢

doc.cheap은 여행 문서 사진을 단 한 번의 HTTP 요청으로 구조화된 JSON으로 바꿔 주는 여권·신분증 OCR API입니다. 이미지를 보내면 기계 판독 영역(MRZ) 파싱, ICAO 9303 체크 디지트 검증, 시각 판독 영역 필드 추출 결과를 같은 응답으로 받습니다. 폴링할 대기열도, 설치할 SDK도 없습니다. 첫 번째 성공 호출까지 60초도 걸리지 않으며 가입이 필요 없습니다. 아래 예제에 공개 sandbox 키가 이미 들어 있습니다. 인식된 문서는 1건당 1¢이며, 첫 번째 문서부터 천만 번째 문서까지 같은 가격입니다. 아무것도 찾지 못한 스캔은 전혀 비용이 들지 않습니다.

라이브 데모 사용해 보기 첫 호출 해 보기

✓ 동기식 호출 한 번
✓ 60초 안에 첫 호출
✓ 가입 없이 시작
✓ 파싱이 필요 없는 평면 JSON

TD3 · 견본

지금 바로 사용해 보기 – 계정도, 카드도, 체험 기간도 필요 없습니다

문서 이미지를 업로드하면 인식된 필드가 화면에 표시됩니다. 데모는 공개 sandbox 키로 여러분의 이미지를 처리합니다. 실제 인식이고, 무료이며, 계정이 필요 없습니다. 옆에 있는 요청은 이와 똑같은 요청이라 그대로 터미널에 붙여 넣을 수 있습니다. 직접 작성하는 코드에 적용하려면 첫 인식 가이드(영문)에서 이어서 진행하세요.

지금 바로 사용해 보기 – 계정 불필요

여권이나 신분증 이미지를 끌어다 놓으면 바로 인식이 시작됩니다. 이미지는 브라우저에서 크기가 조정된 뒤 공개 sandbox로 전송되며, 저장되지 않습니다.

이미지를 여기로 끌어다 놓거나 클릭해서 선택하세요 PNG 또는 JPEG – 이미지를 붙여 넣어도 됩니다

터미널에서 같은 호출 실행하기

curl -X POST https://api.doc.cheap/v1/scans \
  -H "Authorization: Bearer sk_sandbox_public" \
  -H "Content-Type: application/json" \
  -d "{\"image\": \"$(base64 < document.jpg | tr -d '\n')\"}"

이미지를 선택하는 즉시 아래에 인식 결과가 표시됩니다. 모든 필드가 읽힌 각 언어별로 나오며, 기계 판독 영역은 한 자리씩 검증됩니다.

돌려받는 것: 교차 검증된 모든 필드

응답 하나에 판독 결과 전체가 담깁니다. 기계 판독 영역은 ICAO 9303에 따라 한 자리씩 검증되어 하나의 판정으로 반환되고, 판독에 쓰인 줄도 함께 제공됩니다. 페이지에 인쇄된 모든 필드는 고정된 이름으로 다시 매핑되어, 읽힌 언어마다 한 번씩 반환됩니다. 모든 필드에는 각자의 신뢰도가 표시됩니다. 여권 인식하기(영문)에서 호출 전체를 따라가 볼 수 있고, 필드 탐색기에서 모든 키와 그 타입을 확인할 수 있습니다.

문서는 /v1/scans에 대한 POST 한 번으로 들어가고, 같은 응답으로 파싱된 기계 판독 영역, 검증된 체크 디지트, 시각 영역 필드가 돌아옵니다.

document

어떤 종류의 문서가 인식되었는지, 어느 국가가 발급했는지, 번호와 날짜, 만료 여부. 아무것도 인식되지 않으면 null입니다.

kind · country · country_name · issuing_state · type_name · type_confidence · number · series · issue_date · expiry_date · is_expired · days_remaining

holder

문서가 식별하는 사람. 아무것도 인식되지 않으면 null입니다.

given_names · surname · full_name · birth_date · sex · nationality

fields[]

인쇄된 페이지에서 읽은 모든 필드를 고정된 이름으로 다시 매핑한 것. 판독마다 항목이 하나씩 있으며, 각각 언어와 신뢰도 등급을 가집니다.

id · name · label · category · value · language · confidence

mrz

기계 판독 영역: 검증 통과 여부에 대한 판정, 통과하지 못한 경우의 이유, 그리고 읽은 그대로의 줄.

status · reason · lines · text

images

보내신 사진에서 잘라낸 이미지. 각각 data URL 형식입니다.

document_crop · rear · main_photo · signature · watermark_face · barcode · chip

quality

보내신 사진이 인식하기에 충분한 품질이었는지 여부.

overall

authenticity

진위 확인. 인식 전용 호출에서는 실행되지 않으며, 확인되지 않았음(not checked)으로 표시됩니다.

overall · checks

견본 영역, 그리고 파서가 이를 처리하는 방식

가상의 소지자, 가상의 번호, 그리고 이 값들로 계산한 체크 디지트입니다. MRZ 파서에 붙여 넣으면 브라우저 안에서 모든 자리가 다시 계산되는 것을 볼 수 있고, TD1, TD2, TD3의 차이도 읽어 볼 수 있습니다.

P<GRCPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184GRC9403084F3203101PN48291630<<<<72

요금: 문서 1건당 1¢ – 성공했을 때만

1¢ 문서 1건당

누구에게나, 어떤 사용량에서나 같은 가격입니다. 첫 번째 문서와 천만 번째 문서의 가격이 같습니다.

실제로 인식한 문서에만 비용을 냅니다.

흐릿한 사진, 화면에 문서가 없는 경우, 알 수 없는 유형 – 모두 무료입니다. 실패한 스캔에는 절대 비용을 내지 않습니다.

✓ 공개 sandbox 키로 주소당 10건의 인식된 문서까지 무료이며, 계정이 전혀 필요 없습니다. 응답 결과와 관계없이 요청은 시간당 최대 10건입니다.
✓ 가입하면 무료 문서 20건이 잔액에 적립됩니다.

과금 방식 계정 없이 무료로 호출하기

doc.cheap 비교

정가는 각 업체의 요금 페이지에서 직접 확인했고, 해당 페이지로 링크를 걸었습니다. 공개 페이지에서 가격을 확인할 수 없는 업체는 추정하지 않고 제외했습니다. 확인할 수 없는 숫자 하나가 표 전체를 무의미하게 만들기 때문입니다. 전체 비교에서는 실패한 스캔의 비용, 계정 없이 호출할 수 있는 곳, 그리고 각 업체가 저희보다 잘하는 점을 추가로 다룹니다.

문서 인식 서비스의 공개 정가
업체	공개 가격	무료로 시작
doc.cheap	문서당 $0.01, 사용량과 관계없이 정액	공개 sandbox, 가입 불필요
AWS Textract – Analyze ID	월 100,000페이지까지 페이지당 $0.025, 그 이상은 페이지당 $0.01 (us-west-2) 출처	처음 석 달 동안 월 100페이지
Google Document AI	문서당 $0.10 (미국 여권 파서), $0.10 (운전면허증) 출처	–
Mindee	추가 크레딧 "starting from $0.05", 여기에 초과 사용분 20 % 추가 요금 출처	–

실패한 스캔의 비용
doc.cheap	$0 – 문서를 찾지 못한 스캔에는 요금이 부과되지 않으며, 응답의 billed 플래그에 그렇게 표시됩니다.
위의 세 업체	어느 업체의 요금 페이지에도 예외 규정이 공개되어 있지 않습니다.

문서는 물리적으로 저장하지 않습니다

업로드한 이미지는 요청이 처리되는 동안 메모리에만 존재하며, 디스크에 기록되지 않습니다. 보관되는 것은 결과, 즉 처리 결과와 추출된 필드뿐이며 문서의 이미지는 절대 보관되지 않습니다. 보관 기간은 1년, 1개월, 1주, 1일, 또는 전혀 보관하지 않음 중에서 직접 선택합니다.

AI 에이전트를 위한 여권 OCR: MCP 서버

여권을 읽어야 하는 에이전트를 위해 HTTP 클라이언트를 따로 작성할 필요가 없습니다. doc.cheap은 Model Context Protocol 서버를 제공하므로, 어시스턴트는 인식 기능을 도구로 호출합니다. 이미지를 넘기면 똑같은 구조화된 필드가 돌아옵니다. API와 같은 키, 같은 가격, 같은 응답 구조입니다. 별도의 제품이 아닙니다.

MCP 서버와 설치 방법 가이드 읽기

개발자들이 자주 묻는 질문

여권에서 OCR이란 무엇인가요?

광학 문자 인식(OCR)은 문서 사진에 인쇄된 문자를 읽어 텍스트로 바꾸는 기술입니다. 여권에서 읽어야 할 것은 두 가지입니다. 하나는 페이지 하단에 기계가 읽도록 설계된 글꼴로 인쇄된 기계 판독 영역의 두 줄이고, 다른 하나는 그 위에 있는 시각 판독 영역으로, 발급 기관마다 배치가 다른 일반 인쇄 텍스트입니다.

MRZ란 무엇인가요?

기계 판독 영역(MRZ)은 여권이나 신분증 하단에 있는 고정 폭 문자열 블록으로, ICAO Doc 9303으로 표준화되어 있습니다. 문서 번호, 발급 국가, 이름, 국적, 생년월일, 성별, 만료일이 각각 정해진 위치에 기록되며, 판독 결과를 검증하는 체크 디지트가 함께 들어 있습니다.

ICAO Doc 9303이란 무엇인가요?

ICAO Doc 9303(Machine Readable Travel Documents)은 모든 여권과 기계 판독식 신분증이 따르는 규격입니다. 여러 부(Part)로 나뉘어 발행되며, Part 3은 모든 기계 판독식 여행 문서에 공통된 규격을, Part 4, 5, 6은 각각 TD3 여권, TD1 카드, TD2 카드를 다룹니다. 이 규격 덕분에 어디에서 발급된 여권이든 어디에서 만든 판독기로도 읽을 수 있습니다.

여권 OCR API는 오류가 잦나요?

사진을 읽는 일은 무엇이든 틀릴 수 있습니다. 그래서 응답은 무조건 믿는 대신 검증할 수 있도록 설계되어 있습니다. 모든 기계 판독 영역은 자체 ICAO 9303 체크 디지트로 검증되고 그 판정이 응답에 담깁니다. 모든 필드에는 신뢰도 등급이 붙습니다. 그리고 기계 판독 영역과 시각 판독 영역이 서로 다르면, 한쪽을 조용히 택하지 않고 두 판독 결과를 모두 반환합니다.

제 데이터가 저장되나요?

업로드된 이미지는 요청이 처리되는 동안만 메모리에 있으며, 디스크에는 절대 기록되지 않습니다. 보관될 수 있는 것은 결과, 즉 처리 결과와 추출된 필드이며, 보관 기간은 계정별 또는 요청별로 1년부터 0까지 직접 정합니다. 0이면 아무것도 기록되지 않습니다.

무료 체험이나 데모 버전이 있나요?

신청해야 하는 체험판은 없습니다. 먼저 가입해야 하는 것이 아무것도 없기 때문입니다. 문서와 이 페이지의 예제에 공개 sandbox 키가 나와 있으며, 이 키로 실제 인식이 이루어집니다. 가입하면 무료 문서가 잔액에 추가되고, 그다음에는 잔액을 충전하며 인식된 문서 1건마다 크레딧 1개가 차감됩니다.

위조되거나 변조된 문서를 탐지할 수 있나요?

아니요. 그리고 응답은 이를 숨기지 않고 알려 줍니다. 진위 필드의 값은 not_checked입니다. 이 서비스는 인식을 수행하며, 인식은 진위 확인이 아닙니다. 여기서는 문서의 보안 요소를 검사하지 않습니다. 체크 디지트가 통과했다는 것은 영역 내부가 서로 일관된다는 뜻일 뿐이며, 위조 문서를 만드는 사람도 이 부분은 맞춥니다. 체크 디지트가 잡아내는 것은 손상, 빛 반사, 오독입니다.

문서 처리용 MCP 서버란 무엇인가요?

Model Context Protocol은 AI 어시스턴트가 도구에 접근하는 표준입니다. 문서 처리용 MCP 서버는 인식 기능을 어시스턴트가 호출할 수 있는 도구로 제공합니다. 그래서 에이전트는 누구도 HTTP 코드를 작성하지 않고도 여권 이미지를 넘겨 구조화된 필드를 받을 수 있습니다. doc.cheap은 이런 서버를 제공하며, API와 같은 키와 같은 가격을 사용합니다.