Felo API PlatformFelo API Platform

Felo 匯出 PPTX

供應商：Felo · 以平台餘額付款

驗證與設定計費與錯誤完整工作流程指南

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

所有範例都使用來自總覽的 FELO_API_KEY。呼叫會使用 平台餘額，不是 Felo Pro 點數。回應範例僅供說明；實際內容與可選欄位會有所不同。

使用建立任務時回傳的識別碼。將 TASK_ID 設為 task_id，將 PPT_ID 設為 ppt_business_id；{business_id} 也代表 ppt_business_id。

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

4. 開始 PPTX 匯出

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

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/ppts/$PPT_ID/export" \
  -H "Authorization: Bearer $FELO_API_KEY"
{"status":"PROCESSING","download_url":null,"expires_at":null}

匯出之前必須先完成生成。當同一個匯出正在進行時重複送出 POST 會重用它。在完成後再次開始另一個匯出會建立新的匯出，並可能再產生一次費用。請使用 GET 進行輪詢並重新整理下載連結。

生命週期、擁有權與計費

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

需要協助嗎？