핵심 정보 추출 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

매개변수:

매개변수유형필수설명
documentobject문서 객체
document.typestring고정값 "image_url"
document.image_urlstring이미지 URL 또는 base64 데이터
result_schemaobject/stringJSON Schema, 추출할 필드 정의
filenamestring아니오파일명(base64 데이터 사용 시 권장)
keystring아니오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"
  }'

응답

매개변수:

매개변수유형설명
idstring데이터베이스 레코드 ID
filenamestring파일명
contentstring추출된 구조화된 정보(JSON 문자열 형식)
formatstring출력 형식, 고정값 "json"
timestampnumber처리 완료 타임스탬프
payloadstringAPI 엔드포인트 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"
}
핵심 정보 추출 API - LLMOCR Developer Guide