API 문서
핵심 정보 추출 API
인보이스, 증명서, 양식 등 이미지에서 구조화된 정보를 추출하며 사용자 정의 JSON Schema를 지원하고 JSON 형식으로 추출 결과를 반환합니다
개요
핵심 정보 추출 API는 인보이스, 증명서, 양식 등 이미지에서 구조화된 정보를 추출할 수 있으며 사용자 정의 JSON Schema로 추출 필드를 정의하고 JSON 형식으로 추출 결과를 반환합니다. 모델은 이미지의 해당 정보를 지능적으로 인식하여 Schema에 채웁니다.
통일된 JSON 요청 형식을 사용하며 URL 참조 또는 base64 인코딩된 이미지 데이터를 지원합니다.
인증
API는 다음 인증 방법을 지원합니다:
- API 키: 쿼리 매개변수를 통해 API 키 전달
?key=YOUR_API_KEY
이미지에서 구조화된 정보 추출
지능형 인식 기술을 사용하여 이미지 파일에서 구조화된 정보를 추출하며 사용자 정의 JSON Schema를 지원합니다.
요청
POST /api/key-information-extraction매개변수:
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
| document | object | 예 | 문서 객체 |
| document.type | string | 예 | 고정값 "image_url" |
| document.image_url | string | 예 | 이미지 URL 또는 base64 데이터 |
| result_schema | object/string | 예 | JSON Schema, 추출할 필드 정의 |
| filename | string | 아니오 | 파일명(base64 데이터 사용 시 권장) |
| key | string | 아니오 | API 키(쿼리 매개변수, 로그인 사용자 선택 사항) |
result_schema 설명:
- JSON 객체 또는 JSON 문자열일 수 있음
- 최대 3단계 중첩 지원
- key(필드명)만 정의하면 되며 value는 빈 문자열로 유지
- 배열 구조 지원
예제:
이미지 URL 사용:
curl -X POST "https://llmocr.com/api/key-information-extraction?key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"document": {
"type": "image_url",
"image_url": "https://llmocr.com/invoice.jpg"
},
"result_schema": {
"판매자명": "",
"구매자명": "",
"세금 제외 가격": "",
"인보이스 코드": ""
}
}'Base64 이미지 데이터 사용:
curl -X POST "https://llmocr.com/api/key-information-extraction?key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"document": {
"type": "image_url",
"image_url": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA..."
},
"result_schema": {
"이름": "",
"주민등록번호": "",
"주소": ""
},
"filename": "id-card.jpg"
}'응답
매개변수:
| 매개변수 | 유형 | 설명 |
|---|---|---|
| id | string | 데이터베이스 레코드 ID |
| filename | string | 파일명 |
| content | string | 추출된 구조화된 정보(JSON 문자열 형식) |
| format | string | 출력 형식, 고정값 "json" |
| timestamp | number | 처리 완료 타임스탬프 |
| payload | string | API 엔드포인트 URL |
예제:
{
"id": "12345",
"filename": "invoice.jpg",
"content": "{\"판매자명\":\"호북중기자동차판매서비스유한공사\",\"구매자명\":\"채응시\",\"세금 제외 가격\":\"270000.00\",\"인보이스 코드\":\"142011726001\"}",
"format": "json",
"timestamp": 1640995200000,
"payload": "https://llmocr.com/api/key-information-extraction?key=YOUR_API_KEY"
}