이 문서는 영어 원문을 자동 번역한 것으로, 내용이 원문과 다를 수 있습니다.영어 원문 보기
비동기 API로 무엇을 할 수 있나요?
- 장시간 연결을 유지하지 않고도 대용량 문서와 복잡한 스키마를 처리할 수 있어요.
- 배치 처리를 위해 단일 요청으로 여러 문서를 제출할 수 있어요.
- 대규모 문서 처리 워크플로우를 위한 리소스 활용을 최적화할 수 있어요.
즉시 결과가 필요한 단일 문서 처리에는 동기 API를 대신 사용해주세요.
비동기 API와 동기 API는 어떻게 다른가요?
| 한도 | 동기 API | 비동기 API |
|---|---|---|
| 최대 페이지 수 | 100페이지 | 1,000페이지 |
| 최대 파일 크기 | 50MB | 50MB |
| 스키마의 최대 속성 수 | 최대 100개 속성 | 최대 5000개 속성 |
| 스키마의 최대 문자 수 | 최대 15,000자 | 최대 120,000자 |
동작 방식
작업 생성
여러 문서와 추출 스키마를 함께 제출해 비동기 작업을 생성해요. API는 처리가 끝나기를 기다리지 않고 즉시 job_id를 반환해요.
요청
응답
- 지원 파일 형식: PDF, JPEG, PNG, BMP, TIFF, HEIC, DOCX, PPTX, XLSX
- 문서당 최대 파일 크기: 50MB
- 문서당 최대 페이지 수: 1,000페이지
- 페이지당 최대 픽셀 수: 200,000,000 픽셀
- 작업당 최대 문서 수: 최대 20개 문서
- 지원 문자 집합: 영숫자, 한글, 한자가 완전히 지원돼요. 중국어 한자(Hanzi)와 일본어 한자(Kanji)는 베타 버전입니다.
한자(Hanja), 중국어 한자(Hanzi), 일본어 한자(Kanji)는 한자 기반의 문자 체계예요. 자세한 내용은 이 문서를 참고해주세요.
작업 조회
job_id를 사용해 작업 정보를 조회해요. 작업 정보에는 상태, 전체 문서 수, 완료된 문서 수, 생성 시각, 시작 시각, 완료 시각이 포함돼요.
상태는 CREATED, IN_PROGRESS, PARTIALLY_COMPLETED, COMPLETED, FAILED, CANCELED 중 하나입니다.
작업이 완료되면 추출 결과가 응답에 포함돼요.
요청
응답
API 엔드포인트
비동기 API는 세 가지 주요 엔드포인트를 제공해요.
스키마 정의
동기 API와 유사하게, 데이터 추출을 위한 스키마를 정의해야 해요. 스키마는 JSON Schema 문법을 따릅니다. 스키마 작성에 대한 자세한 안내는 스키마 작성하기 페이지를 참고해주세요.
추가 파라미터
비동기 API는 추출 기능을 강화하기 위해 동기 API와 동일한 추가 파라미터를 지원해요.
- mode: 표준(standard) 모드와 향상된(enhanced) 추출 모드 중에서 선택할 수 있어요.
- split: 문서 분할을 활성화해 하나의 파일에 포함된 여러 문서에서 정보를 추출해요.
- location: 위치 좌표를 활성화해 추출된 각 필드에 대한 페이지 번호와 바운딩 박스 좌표를 가져와요.
- confidence: 신뢰도 점수를 활성화해 추출된 각 필드에 대한 신뢰도 점수(
"high"또는"low")를 받아 결과의 신뢰성을 판단할 수 있어요.
모범 사례
- 유사한 문서끼리 배치 처리: 동일한 유형이나 스키마의 문서들을 그룹화하면 더 효율적으로 처리할 수 있어요.
- Job ID 저장: 이후 조회와 감사를 위해 job ID를 보관해 두세요.
- 적절한 폴링 간격 사용: 응답성과 API 사용량의 균형을 위해 5~10초마다 작업 상태를 확인해주세요.
- 성공적으로 완료된 후 결과 다운로드: 결과가 생성되기를 기다리지 않도록, 작업이 완료된 후에 결과를 다운로드해주세요.
- 오류 수정 후 실패한 작업 재시도: 오류를 수정한 뒤 실패한 작업을 재시도해 성공률을 개선해 보세요.