配置 Harness

Landing Page Task API

异步生成落地页并查询任务历史。

POST/v2/landing_page

认证

Bearer API key

Content type

application/json or multipart/form-data

限流说明

可能适用 endpoint 专属限制。

PPT Task API LiveDoc API

Landing Page Task API 用于异步生成落地页。先创建任务，然后复用 task polling APIs 查询进度、历史结果和生成出的 ai_page_html。

认证

Authorization: Bearer YOUR_API_KEY

创建落地页任务

POST https://openapi.felo.ai/v2/landing_page

请求 Body

参数	类型	必填	说明
`query`	string	是	落地页生成需求 prompt
`stream_protocol`	string	否	流式协议，默认 `message_center_v1`
`livedoc_short_id`	string	否	用作上下文的现有 LiveDoc short ID
`resource_ids`	array of strings	否	用作上下文的 LiveDoc 资源 ID

示例

curl -X POST 'https://openapi.felo.ai/v2/landing_page' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"query":"Generate a landing page for Felo Search"}'

Create With File

使用 multipart/form-data 上传一个文件。文件会先作为 LiveDoc resource 上传，再把 resource ID 传给 Landing Page task。

curl -X POST 'https://openapi.felo.ai/v2/landing_page' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'query=Generate a landing page from this product brief' \
  -F '[email protected]'

成功后返回 task_id，用于后续轮询。

Poll Task Status

GET https://openapi.felo.ai/v2/tasks/{task_id}/status

curl -X GET 'https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Query Task Historical Info

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

完成后历史结果会包含 task_status、ppt_biz_id、ppt_url 和 ai_page_html。状态语义与 PPT Task API 共用。

错误码

Code	HTTP Status	说明
`INVALID_API_KEY`	401	API Key 无效或已撤销
`LANDING_PAGE_TASK_CREATE_FAILED`	502	落地页任务创建失败
`INSUFFICIENT_CREDITS`	402	Credits 不足