OCR API는 무료인가요? 요금은 얼마인가요?
신규 계정에는 성공한 호출 5회에 사용할 수 있는 무료 API 크레딧 $0.01이 제공됩니다. 이후 성공한 호출 500회당 $1입니다. 구독은 없고 잔액은 만료되지 않으며 최소 충전 금액은 $5입니다.
$1 / 500
달러당 API 호출
200
분당 요청
5
계정당 API 키
100+
언어
CAPABILITIES
하나의 플랫폼, 세 가지 API
하나의 API 키로 텍스트 추출·표 디지털화·구조화 필드 추출을 잠금 해제합니다 — 각각 즉시 사용 가능한 JSON, CSV, XLSX, DOCX를 반환합니다.
01
이미지→텍스트 API
레이아웃을 유지하며 이미지에서 모든 글자를 추출합니다.
Input: 이미지 (PNG, JPEG, WEBP)
Output: Markdown, 일반 텍스트, DOCX
02
Table OCR API
이미지의 표를 감지하고 구조화된 행으로 디지털화합니다.
Input: 표가 포함된 이미지 (PNG, JPEG, WEBP)
Output: JSON (제목 + HTML), CSV, XLSX
03
데이터 추출 API
청구서·영수증·양식에서 특정 필드를 추출합니다.
Input: 이미지 + 필드 이름
Output: JSON (키 + 값), CSV, XLSX
ENDPOINTS
OCR REST API 참조 및 실제 예제
아래 예제는 모두 복사 가능하며 현재 API와 일치합니다. 한 번 인증하면 모든 엔드포인트를 호출할 수 있습니다.
POST/api/v1/platform/ocr
이미지 텍스트 변환 무료 체험레이아웃을 유지하며 이미지에서 텍스트를 추출합니다. Markdown(기본), 일반 텍스트, DOCX 출력.
Format:
curl -X POST "https://freeocr.ai/api/v1/platform/ocr" \
-H "Authorization: Bearer focr_your_api_key" \
-F "image=@document.png"POST/api/v1/platform/table
표 추출 무료 체험이미지에서 표를 감지하고 구조화 JSON, CSV, XLSX로 추출합니다.
Format:
curl -X POST "https://freeocr.ai/api/v1/platform/table" \
-H "Authorization: Bearer focr_your_api_key" \
-F "image=@spreadsheet.png"POST/api/v1/platform/extract
데이터 추출 무료 체험AI로 이미지에서 특정 필드를 추출합니다. 청구서·영수증·양식에 적합.
Format:
curl -X POST "https://freeocr.ai/api/v1/platform/extract?fields=Invoice%20Number&fields=Date&fields=Total" \
-H "Authorization: Bearer focr_your_api_key" \
-F "image=@invoice.png"AUTH
헤더 하나로 인증
모든 요청의 Authorization 헤더에 API 키를 Bearer 토큰으로 전달하세요.
FORMATS
지원 형식 및 제한
이미지는 multipart/form-data의 image 필드로 전송하세요. 각 엔드포인트는 동일한 입력을 받습니다.
허용 입력
이미지 파일 — PNG, JPEG, WEBP (multipart image 필드)
필드 이름
image (필수)
속도 제한
기본적으로 키당 분당 200요청 (요청 시 조정 가능).
Image handling
이미지는 처리 전 최대 2048×2048 px로 자동 리사이즈됩니다.
REST API는 PDF를 지원하지 않습니다. PDF에는 웹 또는 데스크톱 앱을 사용하세요.
ERRORS
오류 처리 및 과금
성공한 호출만 과금됩니다. 실패한 요청에 대해서는 결코 요금을 내지 않습니다.
$1 = 500회 호출. 성공한 호출 건수만 잔액에서 차감됩니다.
처리가 실패하면 과금액이 잔액으로 자동 환불됩니다.
인증·검증·속도제한·잔액부족 오류는 과금되지 않습니다.
잔액은 달러로 표시되며 실시간으로 갱신됩니다.
오류 코드
401
인증 안 됨 — 잘못되거나 누락된 API 키
400
잘못된 요청 — 이미지 파일 없음 (/extract의 경우 필드 없음)
402
잔액 부족 — 충전하세요
429
속도 제한 초과 — 나중에 재시도
500
내부 오류 — 처리 실패 (과금액 환불)
PRICING
사용량 기반, 구독 없음
숨은 비용 없음. 구독 없음. 사용한 만큼만 결제.
$1
$1당 500회 API 호출
$5
$5 최소 충전
∞
잔액 만료 없음
잔액은 달러로 표시 — $5부터 충전, 성공 시에만 감소.
START
빠른 시작
계정 만들기
API 키 받기
잔액 충전
개발 시작
USES
실제 워크로드용으로 설계
문서 처리 파이프라인부터 모바일 앱 통합까지, 이미지가 데이터가 되어야 하는 곳이면 어디나 OCR API가 어울립니다.
스캔한 문서와 스크린샷을 대규모로 검색 가능한 Markdown이나 DOCX로 변환.
청구서 번호, 날짜, 합계, 품목을 구조화 필드로 자동 추출.
촬영한 스프레드시트와 인쇄된 표를 한 번의 호출로 CSV나 XLSX로 변환.
이미지→텍스트와 데이터 추출을 웹·모바일·데스크톱 제품에 내장.
PRIVACY
귀하의 프라이버시가 중요합니다
개인정보 보호 중심 처리
API 콘텐츠는 OCR 및 데이터 추출 서비스 제공에만 사용됩니다. 데이터 보관을 최소화하며 광고나 관련 없는 목적으로 사용하지 않습니다.
필수 운영 데이터
결제, 보안 및 안정적인 API 운영에 필요한 계정 및 기술 데이터만 처리합니다.
안전한 전송
모든 API 요청은 안전한 HTTPS 연결로 전송되어 전송 중 데이터를 보호합니다.
FAQ
자주 묻는 질문
어떤 파일 형식을 지원하나요?
API는 multipart image 필드로 전송된 이미지 파일(PNG, JPEG, WEBP)을 받습니다. 이미지는 처리 전 최대 2048×2048 px로 자동 리사이즈됩니다. REST API는 PDF를 지원하지 않습니다 — PDF에는 웹 또는 데스크톱 앱을 사용하세요.
OCR·Table·Extraction API의 차이는?
OCR API는 이미지의 모든 텍스트를 Markdown, 일반 텍스트, DOCX로 반환합니다. 표 추출 API는 표를 감지해 JSON(제목 + HTML), CSV, XLSX로 반환합니다. 데이터 추출 API는 지정한 필드 이름을 받아 일치하는 값을 JSON, CSV, XLSX로 반환합니다 — 청구서와 양식에 이상적입니다.
실패한 요청은 과금되나요?
아니요. 성공한 호출만 과금됩니다. 처리가 실패하면 과금액이 잔액으로 자동 환불됩니다. 인증·검증·속도제한·잔액부족 오류는 전혀 과금되지 않습니다.
API 잔액이 만료되나요?
아니요. API 잔액은 만료되지 않습니다. 달러로 표시되며 사용할 때까지 유지됩니다.
API가 PDF를 처리할 수 있나요?
아니요. REST API는 이미지 파일(PNG, JPEG, WEBP)만 처리합니다. PDF를 텍스트나 Word로 변환하려면 PDF 페이지를 직접 처리하는 FreeOCR.AI 웹 또는 데스크톱 앱을 사용하세요.
요청 크기나 속도 제한이 있나요?
기본 속도 제한은 API 키당 분당 200요청이며, 대량 사용자는 요청 시 늘릴 수 있습니다. Vercel의 요청 크기 제한으로 인해 전체 요청 본문은 4.5 MB를 초과할 수 없습니다. 이미지는 처리 전 최대 2048×2048 px로 자동 리사이즈됩니다.
OCR API로 개발할 준비 됐나요?
계정을 만들고 API 키를 받은 뒤 성공한 무료 호출 5회로 디버깅을 시작하세요. 준비되면 $5부터 충전할 수 있습니다.