# Felo 匯出狀態

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

非同步生成簡報，然後匯出為 PPTX 檔案。請將生成與匯出步驟分開：已建立的任務還不是完成的檔案。

所有範例都使用來自[總覽](https://openapi.felo.ai/zh-TW/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 金鑰傳送給檔案下載主機。



## 生命週期、擁有權與計費

- 簡報會在 **建立後七天** 過期。查詢與匯出不會延長這段期間。簡報的 `expires_at` 與簽名下載 URL 的 `expires_at` 代表不同的有效期間。
- 只有建立該任務的 API 帳戶可以存取其任務與簡報。缺少或無法存取的資源可能回傳 404；已過期或已刪除的資源可能回傳 410，或在清理後回傳 404。
- 生成會依每個生成頁面計費（`ppt.generate`）。在頁面計價下，建立時會預留 10 頁的費用，然後結算實際成功輸出並釋放未使用的預留金額。即使提示詞要求的頁數較少，你的帳戶也需要有足夠的可用餘額來完成這項預留。
- 匯出有獨立的請求價格（`ppt.export`）。狀態查詢、結果查詢、匯出狀態查詢與刪除都不會產生新費用。
- 發生逾時後，請查詢已儲存的任務，而不是再建立另一份簡報。請參閱[計費與錯誤](https://openapi.felo.ai/zh-TW/docs/data-api/guides/felo-billing.md)。