image-ocr은(는) 무엇을 하나요?
Tesseract, EasyOCR, PaddleOCR, Google Vision, AWS Textract, Claude Vision 등 다양한 OCR 엔진을 사용하여 이미지에서 텍스트를 추출하는 데 특화된 전문가입니다. 트리거: 이미지, 스크린샷, 스캔 문서 또는 PDF에서 텍스트를 추출할 때.
지원 엔진
| 엔진 | 유형 | 언어 지원 | 참고 사항 |
|---|---|---|---|
| Tesseract | 오픈소스 | 100+ 언어 | LSTM 기반, 로컬 실행 가능 |
| EasyOCR | 오픈소스 | 80+ 언어 | 딥러닝 기반, 설치 간편 |
| PaddleOCR | 오픈소스 | 80+ 언어 | 초고속 추론, 중국어에 강함 |
| Google Vision | Cloud API | 50+ 언어 | 높은 정확도, 유료 |
| AWS Textract | Cloud API | 10+ 언어 | 문서 구조 인식 특화 |
| Claude Vision | AI API | 다국어 | 맥락 이해 능력 탁월 |
사용 방법
1. 이미지 입력
- 로컬 이미지 파일 경로
- URL
- Base64 인코딩 이미지 데이터
- 스크린샷 (클립보드)
2. 엔진 선택 (선택 사항)
# 기본 자동 선택 (권장)
extract_text_from_image(image_path)
# 특정 엔진 지정
extract_text_from_image(image_path, engine="tesseract")
extract_text_from_image(image_path, engine="google_vision")
extract_text_from_image(image_path, engine="easyocr")
3. 결과 출력
추출된 텍스트와 함께 각 엔진별 신뢰도 점수가 반환됩니다.
설정
| 환경 변수 | 설명 | 필수 여부 |
|---|---|---|
GOOGLE_APPLICATION_CREDENTIALS | Google Vision API 인증 파일 경로 | Google Vision 사용 시 필수 |
AWS_ACCESS_KEY_ID | AWS 액세스 키 | AWS Textract 사용 시 필수 |
AWS_SECRET_ACCESS_KEY | AWS 시크릿 키 | AWS Textract 사용 시 필수 |
AWS_REGION | AWS 리전 (기본값: us-east-1) | AWS Textract 사용 시 선택 |
ANTHROPIC_API_KEY | Claude API 키 | Claude Vision 사용 시 필수 |
예시
# 기본 사용
text = extract_text_from_image("document.png")
print(text)
# 특정 엔진과 언어 지정
text = extract_text_from_image("receipt.jpg", engine="tesseract", lang="eng+kor")
print(text)
# 클라우드 API 사용 (고급 기능)
text = extract_text_from_image("invoice.pdf", engine="aws_textract", features=["FORMS", "TABLES"])
print(text)
주의 사항
- 이미지 해상도가 300 DPI 이상인 경우 최상의 결과를 얻을 수 있습니다.
- 스캔된 문서의 경우 왜곡이나 기울기가 있는 경우 전처리가 필요할 수 있습니다.
- 클라우드 API 사용 시 네트워크 연결과 비용이 발생할 수 있습니다.
- 민감한 데이터 처리 시 로컬 엔진(Tesseract, EasyOCR, PaddleOCR) 사용을 권장합니다.
- 각 엔진의 출력 형식은 다를 수 있으며, 자동으로 표준화됩니다.