Felo API PlatformFelo API Platform

Felo 查询导出状态

供应商：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"

5. 查询导出状态并下载

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

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查看错误和任务情况，再决定是否重新导出
{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}

示例地址仅展示结构，请使用真实返回的签名链接。下载链接有效期为 30 分钟；只要演示文稿仍有效，GET 查询导出状态即可获取新的链接。请及时保存文件，不要把 Felo API Key 发送给文件下载域名。

有效期、归属与计费

  • 演示文稿在创建七天后过期，查询和导出不会延长有效期。创建响应和导出响应中的 expires_at 分别表示文稿到期时间与下载链接到期时间。
  • 只能访问当前 API 账户创建的任务和文稿。资源不存在或无权访问可能返回 404；过期或已删除可能返回 410，清理后也可能返回 404。
  • 生成按实际页数计费（ppt.generate）。按页定价时，创建先预留十页费用，生成成功后按实际产出结算并释放未使用部分。即使提示词只要求五页，提交时仍需满足预留额度。
  • 导出单独按请求计费（ppt.export）。生成状态、生成结果、导出状态查询以及删除均不新增费用。
  • 遇到超时，优先查询已保存的任务，不要立即再创建一份。详见计费与错误处理。

需要帮助？