配置 Harness
PPT Task API
创建 PPT 生成任务、列出主题，并轮询共享任务 endpoints。
POST
/v2/ppts认证
Bearer API key
Content type
application/json
限流说明
可能适用 endpoint 专属限制。
PPT Task API 提供异步 PPT 生成能力。你可以创建 task，然后通过 task_id 轮询状态；也可以浏览可用 PPT themes 并在创建任务时应用。
认证
Authorization: Bearer YOUR_API_KEY1. 列出 PPT 主题
GET https://openapi.felo.ai/v2/ppt-themes| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
lang | string | 否 | 本地化内容语言，例如 en、zh-Hans，默认 en |
type | string | 否 | 按 theme type 过滤 |
keyword | string | 否 | 搜索关键词，匹配 theme title |
page | integer | 否 | 页码，从 1 开始 |
size | integer | 否 | 每页数量，最大 100 |
2. 创建 PPT 任务
POST https://openapi.felo.ai/v2/ppts| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query | string | 是 | PPT 生成请求 prompt |
livedoc_short_id | string | 否 | 关联已有 LiveDoc；省略时会自动创建新 LiveDoc |
resource_ids | array of strings | 否 | 用作 PPT 生成上下文 的 LiveDoc 资源 ID |
ppt_config.ai_theme_id | string | 否 | 来自 List PPT Themes 的 Theme ID |
curl -X POST 'https://openapi.felo.ai/v2/ppts' -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"query":"Felo, 2 pages"}'成功响应包含 livedoc_short_id、ppt_business_id 和 task_id。
3. Query Task Status
GET https://openapi.felo.ai/v2/tasks/{task_id}/status4. Query Task Historical Info
GET https://openapi.felo.ai/v2/tasks/{task_id}/historical完成后可能返回 ppt_url、live_doc_short_id、live_doc_url 或 ai_page_html。
说明
- PPT generation 是异步任务，创建后需要轮询 status 或 historical endpoint。
- 如果请求包含 LiveDoc resources，生成内容会结合这些资源。
- 如果任务失败，请保存
task_id并联系 support。