문서 및 파일 도구
OmniDoc은 동기식 파일 도구와 추적 가능한 비동기 문서 작업을 제공합니다. 먼저 기능 엔드포인트를 호출하십시오; 클라이언트에 지원 형식이나 제한 사항을 하드코딩하지 마십시오.
기능 탐색
섹션 제목: “기능 탐색”GET /api/v1/document-operations/capabilitiesGET /api/v1/artifacts/convert/capabilities이들은 현재 열려 있는 작업, 해당 작업의 입력 형식, 결제 및 기술적 제한 사항을 반환합니다. unavailable 아래에 나열된 기능은 생성할 수 없습니다.
비동기 문서 작업
섹션 제목: “비동기 문서 작업”POST /api/v1/document-operationsIdempotency-Key: unique-request-id{ "document_id": "4q8mx2q9z1k7p6ra", "kind": "visual_extract"}이 엔드포인트에는 Idempotency-Key이 필요합니다. 현재 kind에는 다음이 포함됩니다:
extract: 구조화된 추출, 무료.pdf_to_html: PDF에서 온라인 HTML으로, 무료.visual_extract: 시각적 구조화 추출, 페이지당 요금 부과(페이지당 1 크레딧). 시작 전에 잔액에서 처리 가능한 페이지 수가 설정되며(최대 20페이지), 잔액이 1페이지 미만인 경우402를 반환합니다. 종료 시 실제로 처리된 페이지에 대해 요금이 부과되며, 잔액이 마이너스가 될 수 있습니다.
쿼리 및 취소:
GET /api/v1/document-operations/{operation_id}GET /api/v1/document-operations?limit=25POST /api/v1/document-operations/{operation_id}/cancel완료되면 응답의 output_document_id은 파일 라이브러리나 다른 작업으로 이동할 수 있으며, credit_operation_id은 정산 기록을 제공합니다.
PDF 도구
섹션 제목: “PDF 도구”POST /api/v1/file-tools/pdf/mergePOST /api/v1/file-tools/pdf/splitPOST /api/v1/file-tools/pdf/compress병합 예시:
{"document_ids":["4q8mx2q9z1k7p6ra","b6t1n8c3v9m2x5ka"]}분할 예시:
{"document_id":"4q8mx2q9z1k7p6ra","ranges":["1-3","5","8-10"]}이미지 도구
섹션 제목: “이미지 도구”POST /api/v1/file-tools/image/convertPOST /api/v1/file-tools/image/compress{ "document_id": "4q8mx2q9z1k7p6ra", "target_format": "webp", "quality": 85}이 도구들은 현재 계정이 소유하고 파일 유형이 일치하는 문서만 처리합니다. 바이너리 응답을 스트리밍하며, 파일 이름과 유형은 응답 헤더에서 가져옵니다.