콘텐츠로 이동

문서 및 파일 도구

OmniDoc은 동기식 파일 도구와 추적 가능한 비동기 문서 작업을 제공합니다. 먼저 기능 엔드포인트를 호출하십시오; 클라이언트에 지원 형식이나 제한 사항을 하드코딩하지 마십시오.

GET /api/v1/document-operations/capabilities
GET /api/v1/artifacts/convert/capabilities

이들은 현재 열려 있는 작업, 해당 작업의 입력 형식, 결제 및 기술적 제한 사항을 반환합니다. unavailable 아래에 나열된 기능은 생성할 수 없습니다.

POST /api/v1/document-operations
Idempotency-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=25
POST /api/v1/document-operations/{operation_id}/cancel

완료되면 응답의 output_document_id은 파일 라이브러리나 다른 작업으로 이동할 수 있으며, credit_operation_id은 정산 기록을 제공합니다.

POST /api/v1/file-tools/pdf/merge
POST /api/v1/file-tools/pdf/split
POST /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/convert
POST /api/v1/file-tools/image/compress
{
"document_id": "4q8mx2q9z1k7p6ra",
"target_format": "webp",
"quality": 85
}

이 도구들은 현재 계정이 소유하고 파일 유형이 일치하는 문서만 처리합니다. 바이너리 응답을 스트리밍하며, 파일 이름과 유형은 응답 헤더에서 가져옵니다.