빠른 시작

이 가이드는 cURL과 PDF-to-Markdown 엔드포인트를 사용합니다. 동일한 제출 후 폴링 패턴이 EPUB 변환에도 적용됩니다.

1. API 키 생성

OOMOL Console에서 API 키를 생성하세요. 서버나 시크릿 관리자에 보관하고, 브라우저 번들이나 공개 클라이언트 애플리케이션에 절대 포함하지 마세요.

2. 변환 작업 제출

샘플 키와 PDF URL을 교체한 다음 제출 엔드포인트로 요청을 보내세요.

curl --request POST "https://fusion-api.oomol.com/v1/pdf-transform-markdown/submit" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "pdfURL": "https://pdfcraft.ai/examples/api-quickstart.pdf",
    "model": "gundam"
  }'

응답에는 작업 ID인 sessionID가 포함됩니다. 이를 자체 작업 기록과 함께 저장하고 아래의 TASK_ID 대신 사용하여 재시도와 다운로드를 추적할 수 있도록 하세요.

3. 결과 폴링

상태가 completed 또는 failed가 되거나 최대 시도 횟수나 기한에 도달할 때까지 결과 엔드포인트를 요청하세요. 2xx가 아닌 응답은 오류로 처리하고 state를 알 수 없으면 폴링을 중단하세요. 짧은 지연으로 시작하고 더 긴 문서의 경우 시도 사이에 백오프하세요.

curl --request GET "https://fusion-api.oomol.com/v1/pdf-transform-markdown/result/TASK_ID" \
  --header "Authorization: Bearer YOUR_API_KEY"

state에서 작업 상태를 읽으세요. completed이면 data.downloadURL에서 생성된 파일을 다운로드하고, failed이면 반환된 실패 이유를 기록하고 처리하세요.

다음 단계

• 인증, 작업 상태 및 재시도에 대해서는 API 개요를 검토하세요.
• 필드 수준의 요청 및 응답 세부 정보가 필요할 때는 API Reference를 사용하세요.

전체 예제 실행

Python 3 예제를 다운로드하고 내용을 확인하세요. 환경 변수 PDF_CRAFT_API_KEY를 읽고 크레딧이 차감될 수 있는 변환을 한 번 제출한 뒤, 작업 ID를 저장하고 제한 시간 내에 결과를 조회하고 검증합니다. 중단 후에는 다시 제출하지 말고 같은 작업을 이어서 조회하세요.

python3 api-quickstart.py
python3 api-quickstart.py --resume pdf-craft-task.json