# 빠른 시작

[HTML](https://pdfcraft.ai/ko-KR/docs/getting-started/quickstart/) · [Site index](https://pdfcraft.ai/llms.txt)

PDF 변환 작업을 제출하고 몇 분 안에 결과를 가져옵니다.


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

## 1. API 키 생성

[OOMOL Console](https://console.oomol.com/api-key)에서 API 키를 생성하세요. 서버나 시크릿 관리자에 보관하고, 브라우저 번들이나 공개 클라이언트 애플리케이션에 절대 포함하지 마세요.

## 2. 변환 작업 제출

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

```bash
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`를 알 수 없으면 폴링을 중단하세요. 짧은 지연으로 시작하고 더 긴 문서의 경우 시도 사이에 백오프하세요.

```bash
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 개요](https://pdfcraft.ai/ko-KR/docs/api/overview/)를 검토하세요.
- 필드 수준의 요청 및 응답 세부 정보가 필요할 때는 [API Reference](https://pdfcraft.ai/ko-KR/api/)를 사용하세요.

## 전체 예제 실행

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

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