PLUT OCR API
한국어 문서를 필드 JSON으로 받는 OCR API
신분증·사업자등록증·영수증·계약서·표·손글씨를 올리면 글자, 표, 문서별 필드를 JSON으로 돌려드려요. 쓴 만큼 크레딧으로 내요.
API 키마다 매달 100쪽 무료 · 1쪽 = 이미지 1장 또는 PDF 1페이지 · 결제는 팀플럿 결제창(토스페이먼츠)에서 해요.
1,000쪽
9,900원
1쪽 9.9원 · 부가세 포함
10,000쪽
79,000원
1쪽 7.9원 · 부가세 포함
50,000쪽
290,000원
1쪽 5.8원 · 부가세 포함
| 모든 상품에 같아요 | 내용 |
|---|---|
| 문서 종류 | 신분증, 사업자등록증, 영수증, 계약서, 표, 손글씨, 일반 문서(자동 판별) |
| 처리 | 기울기·원근 보정, 두 인식 엔진 앙상블, 표 구조(병합 칸 포함), 문서별 필드 추출과 검증(사업자번호 검증 숫자, 영수증 합계) |
| 개인정보 | 주민등록번호 뒤 7자리 자동 가림, 원본과 결과 저장 안 함 |
| AI 교정(정밀 모드) | 준비 중이에요. 켜지면 1쪽을 3쪽으로 계산하고, 미리 알려 드려요. |
| 유효기간 | 결제일부터 1년(만료 30일 전 메일 안내) |
크레딧 충전
크레딧 결제
01 · API 키
API 키 받기
이메일로 확인 링크를 보내 드려요. 링크를 열면 키가 한 번만 보여요. 매달 100쪽은 무료예요.
API 키가 발급됐어요. 지금 한 번만 보여요. 안전한 곳에 복사해 두세요.
02 · 결과 미리 보기
키 없이 결과 JSON 보기
API와 같은 엔진으로 처리해요. 하루 10쪽, 5MB까지예요. 올린 파일과 결과는 저장하지 않아요. 주민등록번호 뒷자리는 자동으로 가려서 보여 드려요. 본인 신분증만 올려 주세요.
필드
{ "결과": "파일을 올리면 여기에 JSON이 보여요" }
03 · 빠른 시작
API 문서
curl
curl -X POST https://kryft.io/api/ocr/v1/ocr \
-H "Authorization: Bearer plut_ocr_live_..." \
-F "file=@사업자등록증.jpg" \
-F "doc_type=biz_reg"
Python
import requests
r = requests.post(
"https://kryft.io/api/ocr/v1/ocr",
headers={"Authorization": "Bearer plut_ocr_live_..."},
files={"file": open("receipt.jpg", "rb")},
data={"doc_type": "receipt"},
)
print(r.json()["fields"])
응답(사업자등록증, 일부)
{
"ok": true,
"doc_type": "biz_reg",
"fields": {
"biz_no": "266-23-70221",
"company": "하늬바람 카페",
"representative": "배지우",
"open_date": "2013.05.23",
"biz_type": "교육 서비스업",
"biz_item": "일반 교습 학원"
},
"warnings": [],
"masked": [],
"stored": false,
"n_pages": 1,
"billing": {"pages": 1, "free_pages": 1, "paid_pages": 0}
}
예시 값은 합성 견본이에요.
| 요청 | 설명 |
|---|---|
POST /api/ocr/v1/ocr | multipart file(필수), doc_type: auto · id_card · biz_reg · receipt · contract · table · handwriting · general. 이미지 바이트를 그대로 보내도 돼요(Content-Type: image/*, application/pdf). |
GET /api/ocr/v1/usage | 이번 달 사용 쪽수, 남은 무료 한도, 크레딧 잔액 |
GET /api/ocr/v1/health | 엔진 연결 상태 |
| 응답 공통 | text(전체 글), pages[].lines[](줄·좌표·신뢰도), pages[].tables[](HTML·2차원 배열), fields(문서별 필드), warnings(검증 실패), masked(가린 항목), stored: false |
| 문서별 필드 | 신분증: name, rrn(뒤 7자리 가림), birth_date, address, issue_date, issuer, id_kind · 사업자등록증: biz_no, company, representative, open_date, corp_no, address, biz_type, biz_item, issue_date, tax_office · 영수증: store, biz_no, datetime, items[], supply, vat, total, card_masked, approval_no · 계약서: title, party_a, party_b, start_date, end_date, amount, clauses[] · 표: tables[] |
| 제한 | 파일 10MB, PDF 20쪽, 키당 초당 2건. 처리하지 못한 호출(오류·시간 초과)은 차감하지 않아요. |
| 오류 코드 | 401 키 없음 · 402 한도·크레딧 부족(checkout 주소 포함) · 413 파일 큼 · 422 읽을 수 없는 형식 · 429 요청 많음 · 503 엔진 연결 지연 |
결제 전에 꼭 확인해 주세요
- 판매자
- 팀플럿(주) · 대표이사 김소연 · 경기 이천시 경충대로2762번길 29-107 102-J1호 · 1522-2841 · hello@teamplut.com · 사업자등록번호 461-81-04253 · 통신판매업 신고 제2026-경기이천-0527호
- 상품
- PLUT OCR API 크레딧 1,000쪽 9,900원 · 10,000쪽 79,000원 · 50,000쪽 290,000원(부가세 포함, 선결제). 1쪽은 이미지 1장 또는 PDF 1페이지예요.
- 공급
- 결제가 끝나면 결제할 때 적은 이메일의 API 키 계정에 바로(늦어도 1분 안) 충전돼요. 키를 아직 받지 않았으면 같은 이메일로 키를 받을 때 충전돼 있어요. 자동 충전·정기 결제는 없어요.
- 유효기간
- 결제일부터 1년이에요. 만료 30일 전에 이메일로 알려 드려요. 크레딧은 PLUT OCR API에만 쓸 수 있고 다른 계정으로 넘기거나 현금으로 바꿀 수 없어요.
- 청약철회·환불
- 결제일부터 7일 안에 한 쪽도 쓰지 않았으면 전액, 일부를 썼으면 남은 쪽수 비율만큼 환불해요. 이미 쓴 쪽은 서비스가 제공된 것이라 환불되지 않아요. 결제 전에 매달 100쪽 무료 한도와 결과 미리 보기로 먼저 써 볼 수 있어요. 서비스가 표시·광고와 다르게 제공되면 공급받은 날부터 3개월 안, 그 사실을 안 날부터 30일 안에 철회할 수 있어요. 환불은 요청을 받은 날부터 3영업일 안에 카드 결제 취소로 해요.
- 저장하지 않아요
- 올린 문서와 인식 결과는 메모리에서만 처리하고 응답 뒤 지워요. 남는 것은 키 번호·시각·문서 종류·쪽수·처리 시간 같은 이용 기록뿐이에요.
- 기술 사항
- 지원 형식 JPG·PNG·WEBP·TIFF·PDF, 파일 10MB, PDF 20쪽, 키당 초당 2건. 결과의 정확도는 원본 화질에 따라 달라지고 개별 문서의 결과를 보장하지 않아요. 공개 측정표는 표에 적힌 평가셋 기준이에요.
- 문의·분쟁
- hello@teamplut.com · 1522-2841. 3영업일 안에 처리 결과나 일정을 알려 드려요.
- 미성년자
- 미성년자가 법정대리인의 동의 없이 결제한 경우 본인이나 법정대리인이 계약을 취소할 수 있어요.