플랫폼 개요
OmniDoc API는 하나의 계정 내에서 파일 및 콘텐츠 워크플로를 처리합니다. 호출자는 API 키를 사용하여 리소스를 생성한 다음, 반환된 고유 ID를 활용해 해당 리소스를 조회, 결합, 처리하거나 다운로드할 수 있습니다.
리소스 모델
섹션 제목: “리소스 모델”| 리소스 | 목적 |
|---|---|
| 문서 / 파일 | 계정이 소유한 소스 파일 및 파일 라이브러리 항목 |
| 작업 / 작업 단계 | 비동기 번역, 문서 처리 또는 오디오 및 비디오 작업 |
| 아티팩트 | 미리보기 또는 다운로드를 위해 작업이 제공하는 결과 |
| 크레딧 작업 | 한 번의 청구 가능 작업에 대해 부과되고 환급된 내역 |
모든 리소스는 소유 계정을 기준으로 검증됩니다. 클라이언트는 공개 ID만 유지하면 되며, ID, 파일 이름 또는 다운로드 주소로부터 구현 세부 사항을 유추해서는 안 됩니다.
일반적인 호출 흐름
섹션 제목: “일반적인 호출 흐름”- 입력 리소스를 생성하거나 선택하십시오.
- 계정에 크레딧이 있는지 확인하십시오. 작업 시작 전 잔액이 임계값과 비교되며, 작업 완료 시 실제 사용량이 청구됩니다.
Idempotency-Key을 사용하여 작업을 생성하십시오.- 작업 상태를 확인하십시오. 파일 번역 작업에는 SSE 또는 웹훅도 사용할 수 있습니다.
- 이 작업의 결과와 크레딧 기록을 확인하십시오.
정체성
섹션 제목: “정체성”외부 통합은 항상 API 키를 사용하며, 해당 키를 생성한 계정과 동일한 권한을 갖습니다. 인증 을 참조하십시오.
빠른 시작 → 파일을 업로드하고, 작업을 생성하며, 상태를 확인한 뒤 결과를 다운로드합니다.