# Felo 내보내기 상태

GET /api/v1/data/ppts/{business_id}/export

프레젠테이션을 비동기로 생성한 다음 PPTX 파일을 내보내세요. 생성과 내보내기 단계를 분리하세요. 생성된 작업은 아직 완성된 파일이 아닙니다.

모든 예시는 [개요](https://openapi.felo.ai/ko/docs/data-api/guides/felo-overview.md)의 `FELO_API_KEY`를 사용합니다. 호출은 Felo Pro 크레딧이 아니라 **플랫폼 잔액**을 사용합니다. 응답 예시는 설명용이며, 실제 콘텐츠와 선택적 필드는 달라질 수 있습니다.



작업을 생성할 때 반환된 식별자를 사용하세요. `TASK_ID`는 `task_id`로, `PPT_ID`는 `ppt_business_id`로 설정하세요. `{business_id}` 역시 `ppt_business_id`를 의미합니다.

```bash
TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"
```



## 5. 내보내기 폴링 및 다운로드

`GET /api/v1/data/ppts/{business_id}/export`

```bash
curl -sS --request GET "https://openapi.felo.ai/api/v1/data/ppts/$PPT_ID/export" \
  -H "Authorization: Bearer $FELO_API_KEY"
```

| 상태 | 다음 작업 |
|---|---|
| `NOT_STARTED` | 내보내기를 한 번 제출하세요 |
| `PROCESSING` | 기다린 후 GET으로 다시 폴링하세요 |
| `COMPLETED` | `download_url`을 읽고 파일을 다운로드하세요 |
| `FAILED` | 새 내보내기를 제출하기 전에 오류와 작업 상태를 검토하세요 |

```json
{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}
```

예시 URL은 설명용입니다. 응답의 실제 서명된 URL을 사용하세요. 이 링크는 **30분** 동안 유효합니다. GET 내보내기 상태는 프레젠테이션이 계속 사용 가능한 동안 새 링크를 반환할 수 있습니다. 파일은 유효 기간 내에 저장하세요. Felo API 키를 파일 다운로드 호스트로 보내지 마세요.



## 수명, 소유권 및 청구

- 프레젠테이션은 **생성 후 7일**에 만료됩니다. 조회와 내보내기는 이 기간을 연장하지 않습니다. 프레젠테이션 `expires_at`과 서명된 다운로드 URL `expires_at`은 서로 다른 수명을 나타냅니다.
- 생성한 API 계정만 자신의 작업과 프레젠테이션에 접근할 수 있습니다. 누락되었거나 접근할 수 없는 리소스는 404를 반환할 수 있으며, 만료되었거나 삭제된 리소스는 410을 반환하거나 정리 후 404가 될 수 있습니다.
- 생성은 생성된 페이지당(`ppt.generate`) 과금됩니다. 페이지 가격 책정에서는 생성 시 10페이지 가격을 예약한 다음 실제 성공 출력으로 정산하고 사용되지 않은 예약분을 해제합니다. 프롬프트가 더 적은 페이지를 요청하더라도 계정에는 예약에 충분한 가용 잔액이 있어야 합니다.
- 내보내기는 별도의 요청 가격(`ppt.export`)이 있습니다. 상태 조회, 결과 조회, export-status 조회, 삭제는 새 요금을 발생시키지 않습니다.
- 타임아웃 후에는 새 프레젠테이션을 만들지 말고 저장된 작업을 조회하세요. [청구 및 오류](https://openapi.felo.ai/ko/docs/data-api/guides/felo-billing.md)를 참조하세요.