Skip to main content

Felo PPT API 現已支援匯出真正的 PPTX 檔案

· 閱讀時間約 7 分鐘
Felo Search Tips Buddy
Felo Search Tips Buddy
Committed to answers at your fingertips

Felo OpenAPI 的 PPT 任務 API 現可將生成的簡報匯出為可編輯的 .pptx 檔案。只需一組 API 金鑰、四步非同步流程，以及下載連結。

你的代理人可以研究主題、建立大綱，並生成完整的簡報，不需操作設計工具。唯一缺少的功能是無法直接提供團隊可在 PowerPoint 開啟的檔案。

這個缺口已經補上。Felo OpenAPI 現可將生成的簡報匯出為真正的 .pptx 檔案。 PPT 任務 API 原本可在 Felo 內產生可編輯的投影片，新的匯出端點則將它們轉換為可下載、編輯、分享的 PowerPoint 檔案。相同的 API 金鑰、相同的非同步流程，只需多一次呼叫。

立即體驗：https://openapi.felo.ai/docs/api-reference/ppt-tasks

Felo PPT 任務 API 現可匯出真正的 .pptx 檔案：研究到簡報一氣呵成，POST /v2/ppts/{id}/export，download_url 有效 30 分鐘

實際改變了什麼​

在這次更新之前，PPT 任務 API 只會產生 Felo 投影片的網址。你得到一份簡報，但交接就到此為止：若要展示給客戶、班級或董事會，必須手動在 PowerPoint 重建內容。

現在流程完整。當 PPT 生成任務達到 COMPLETED，你呼叫一個匯出端點並輪詢另一個。API 會回傳一個簽名的 download_url，指向真正的 .pptx 檔案——同一份簡報，大家習慣的格式。

這不只是格式轉換，還有兩個重點：

  • 簡報可編輯。 不是 PDF，也不是平面圖片。文字、版面、主題結構都保留到 PowerPoint，同事可以修改數字或調整段落，不需重新生成。
  • 研究已完成。 Felo 的 PPT 生成不只是把提示內容放上投影片。它會研究主題、收集資料來源、組織論點並套用主題。你拿到的是可直接展示的簡報，而不是需要重寫的初稿。

這種結合才是關鍵。多數工具要嘛研究完整但只給你文字，要嘛格式漂亮但內容空洞。Felo 兩者兼具，現在還能直接提供檔案。

匯出流程說明​

匯出採用非同步方式，與 PPT 任務 API 其他部分一致。你提交工作、輪詢直到完成，然後下載結果。

步驟一 — 生成簡報​

用提示建立 PPT 任務。若想指定風格，先列出可用主題並傳入主題 ID。

POST https://openapi.felo.ai/v2/ppts
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "query": "Q3 competitive landscape review, 12 pages",
  "ppt_config": {
    "ai_theme_id": "02968979-a69f-42c4-b136-de02c40ab2d7"
  }
}

回應會給你 task_id 和 ppt_business_id。兩者都要保留——task ID 用來輪詢生成狀態，business ID 用來匯出。

步驟二 — 輪詢直到簡報完成​

GET https://openapi.felo.ai/v2/tasks/{task_id}/historical
Authorization: Bearer YOUR_API_KEY

每 2–5 秒輪詢一次。當 task_status 顯示 COMPLETED，簡報已生成，可以匯出。若想先預覽投影片，會同時回傳 ppt_url。

步驟三 — 提交匯出請求​

POST https://openapi.felo.ai/v2/ppts/YOUR_PPT_BUSINESS_ID/export
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{}

這就是完整的請求內容：{}。匯出會以背景工作方式執行。

步驟四 — 輪詢匯出並下載檔案​

GET https://openapi.felo.ai/v2/ppts/{ppt_business_id}/export
Authorization: Bearer YOUR_API_KEY

每 2–5 秒輪詢一次。data.status 會經過 NOT_STARTED、PROCESSING、COMPLETED。只有 COMPLETED 會帶你要的內容：

{
  "status": "ok",
  "message": null,
  "data": {
    "status": "COMPLETED",
    "download_url": "https://example.com/presentation.pptx?signature=...",
    "expires_at": "2026-09-29T10:30:00Z"
  }
}

從 download_url 下載檔案即可。

PPTX 匯出流程：POST /v2/ppts 建立簡報，GET /v2/tasks/{task_id}/historical 輪詢直到 COMPLETED，POST /v2/ppts/{id}/export 啟動匯出，GET /v2/ppts/{id}/export 回傳 download_url 有效 30 分鐘

四個出貨前必知細節​

下載連結發出後 30 分鐘內有效。 這是簽名網址，不是永久連結。若過期，再呼叫 GET 匯出端點即可——會產生新連結，不會重新生成 PPTX，不會扣額度。

匯出完成後重複匯出會扣額度。 匯出處理中時重複 POST 沒問題，不會啟動第二個工作。但匯出完成後再次 POST 會重新生成檔案並扣除現有 PPT 匯出額度。若只需新連結，請用 GET。

API 金鑰必須擁有簡報。 匯出限定於建立該 PPT 的金鑰。未生成簡報的金鑰無法匯出，簡報只會留在原帳戶。

失敗可重試。 匯出 FAILED 可用同樣的 POST 再提交。額度不足會回傳 HTTP 402；速率限制回傳 HTTP 429，稍後重試即可。

對代理人有何意義​

重點不在檔案格式，而是完整的研究到檔案流程帶來的可能性。

能研究又能匯出的代理人，現在可全自動完成流程：

  • 每週業務回顧 — 抓取週數據、研究背景、生成簡報、匯出檔案，週一會議前將 .pptx 放進共享雲端。
  • 客戶交付 — 將簡報需求轉成有資料來源、有主題的簡報，交付客戶可自行品牌化的可編輯檔案。
  • 銷售支援 — 根據帳戶研究生成專屬簡報，匯出檔案，自動附加到 CRM。
  • 課程與訓練教材 — 研究主題、組織成課程、匯出投影片，教師可在上課前編輯。

每種情境下，人員只需審查與潤飾。不再從空白投影片開始。

若不想自己寫輪詢流程，Felo PPT Skill 已包好。安裝 Felo AI agent 套件，代理人即可一站式建立、輪詢、匯出簡報——同樣流程，已包裝好讓代理人直接呼叫。

開始使用​

匯出功能已在 PPT 任務 API 上線，所有 Felo OpenAPI 金鑰皆可用。

  1. 從 Felo OpenAPI 控制台取得你的 API 金鑰。
  2. 閱讀 PPT 任務 API 文件——Export PPTX 章節有完整請求與回應格式。
  3. 生成簡報、匯出檔案、用 PowerPoint 開啟。

若想快速上手，安裝 Felo PPT Skill，讓代理人自動完成整個流程。

開始用 Felo OpenAPI 開發：https://openapi.felo.ai

常見問題​

匯出的檔案真的能在 PowerPoint 編輯嗎？ 可以。匯出會產生標準 .pptx 檔案。文字、版面、主題結構都會保留，可在 PowerPoint、Google Slides 或 Keynote 編輯。

匯出會額外扣費嗎？ 簡報生成後提交匯出會扣除現有 PPT 匯出額度。額度不足會回傳 HTTP 402。用 GET 重新取得下載連結不會重新生成檔案，也不會扣費。

下載連結有效多久？ 自發出起 30 分鐘。需新連結時再呼叫 GET 匯出端點即可。

能匯出用其他 API 金鑰建立的簡報嗎？ 不能。提出匯出請求的 API 金鑰必須擁有該 PPT。

匯出失敗會怎樣？ data.status 會回傳 FAILED。再次提交 POST 匯出請求即可重試。

本文也提供以下語言版本：English、简体中文、日本語、한국어、हिन्दी、Français、العربية、Русский、اردو、Bahasa Indonesia、Deutsch、Tiếng Việt、Türkçe、Italiano、ไทย、Español、বাংলা、Português。