
문서용 OCR은 PDF와 이미지를 페이지별로 구조화된 Markdown으로 읽어내며, 표, 수학, 차트, 이미지 영역, 레이아웃을 포함합니다.
문서용 OCR은 PDF와 이미지를 페이지별로 구조화된 Markdown으로 읽어내며, 표, 수학, 차트, 이미지 영역, 레이아웃을 포함합니다.
다른 이름 LightOnOCR-3-4B
lightonocr-3-4b/v1/ocrlightonai/lightonocr-3-4bEmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 사용한 만큼만 결제하며 월 최소 요금이 없습니다.
LightOnOCR-3 4B은(는) POST /v1/ocr로 PDF와 이미지를 읽고 각 페이지를 Markdown으로 반환합니다. PDF의 URL을 document에 담아 모델 ID lightonocr-3-4b와 함께 보내세요. 일부 페이지만 처리하려면 0부터 시작하는 페이지 번호를 pages에 지정하세요. 이미지는 {"type": "image_url", "image_url": "https://..."}로 같은 방식으로 보낼 수 있으며, 두 URL 모두 base64 데이터 URI로 보낼 수도 있습니다. 응답의 pages에는 각 페이지의 index, markdown, images, tables, dimensions가 담기고, usage_info.pages_processed는 처리된 페이지 수를 알려 줍니다. 몇 분이 지나도 처리 중인 요청은 job_id를 반환하므로 GET /v1/jobs/{job_id}을 폴링하세요. Prefer: respond-async 헤더를 보내면 작업 ID를 바로 받을 수 있습니다. EmpirioLabs 대시보드에서 API 키를 발급받으세요.
curl https://api.empiriolabs.ai/v1/ocr \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "lightonocr-3-4b",
"document": {
"type": "document_url",
"document_url": "https://arxiv.org/pdf/2412.13663"
},
"pages": [0, 1],
"include_image_base64": false
}'import requests
response = requests.post(
"https://api.empiriolabs.ai/v1/ocr",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
json={
"model": "lightonocr-3-4b",
"document": {
"type": "document_url",
"document_url": "https://arxiv.org/pdf/2412.13663",
},
"pages": [0, 1],
"include_image_base64": False,
},
)
result = response.json()
for page in result["pages"]: # index, markdown, images, tables, dimensions
print(page["index"], page["markdown"][:200])
print(result["usage_info"]["pages_processed"])EmpirioLabs에서 LightOnOCR-3 4B API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.
| 파라미터 | 유형 | 기본값 | 범위 / 값 | 설명 |
|---|---|---|---|---|
| document | object | - | - | 읽기 위한 PDF(document_url) 또는 이미지(image_url)는 공개 URL 또는 base64 데이터 URI로 최대 50MB까지 읽을 수 있습니다. |
| pages | string | - | - | 읽을 수 있는 페이지는 0 기반 이며, [0, 2] 같은 리스트나 0,2-4 같은 문자열로 표시됩니다. 비어 있을 때는 각 페이지가 최대 1,000까지 가능합니다. |
| include_image_base64 | boolean | false | - | 페이지의 각 이미지 영역을 JPEG 데이터 URI로 반환하세요. |
| table_format | enum | - | markdown, html | 각 테이블을 이 형식으로 개별적으로 반환하세요. 테이블은 설정되지 않으면 HTML로 마크다운 페이지에 남아 있습니다. |
| extract_header | boolean | false | - | 페이지 헤더를 마크다운에서 별도의 필드로 옮기세요. |
| extract_footer | boolean | false | - | 페이지 푸터를 마크다운에서 별도의 필드로 옮기세요. |
| image_limit | integer | - | 최소 0 | 문서 전체에 대해 최대 이 정도의 이미지만 반환하고, 첫 번째 이미지부터 가져가세요. |
| image_min_size | integer | - | 최소 0 | 이 픽셀 수보다 좁거나 짧은 이미지 영역은 제외하세요. |
| include_blocks | boolean | true | - | 각 페이지의 모든 영역을 읽기 순서대로 포함하고, 그 종류, 위치, 내용이 포함되어야 합니다. |
PDF와 이미지를 페이지별로 Markdown에 읽어줍니다: 텍스트를 읽기 순서, 제목, 목록, 표, 수학, 캡션, 차트와 그 데이터 포인트를 표로 정리합니다.
EmpirioLabs에서 LightOnOCR-3 4B은(는) 종량제로 청구됩니다: 문서 OCR $3.00 1,000페이지당 최소 5페이지씩 요청당. 이 페이지의 실시간 요금표는 항상 API 청구 금액과 일치합니다.
LightOnOCR-3 4B은(는) api.empiriolabs.ai의 POST /v1/ocr를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.
네. EmpirioLabs 플레이그라운드에서 API와 동일한 파라미터로 LightOnOCR-3 4B을(를) 브라우저에서 실행하므로 코드를 작성하기 전에 프롬프트를 테스트할 수 있습니다.
EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.