Harness 설정

Landing Page Task API

Landing page를 비동기로 생성하고 task history를 조회하세요.

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는 async landing page generation을 위한 API입니다. task를 만들고 shared task polling APIs로 progress, history, generated ai_page_html을 조회합니다.

인증

Authorization: Bearer YOUR_API_KEY

Landing Page 작업 생성

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

요청 Body

파라미터	타입	필수	설명
`query`	string	예	landing page generation prompt
`stream_protocol`	string	아니요	Stream protocol. Default: `message_center_v1`
`livedoc_short_id`	string	아니요	Existing LiveDoc short ID to use as context
`resource_ids`	array of strings	아니요	LiveDoc resource IDs to use as context

예시

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

Upload one file with multipart/form-data. The file is first uploaded as a LiveDoc resource, then its resource ID is passed to the 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]'

The response returns task_id for polling.

Poll Task Status

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

Query Task Historical Info

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

Historical result includes task_status, ppt_biz_id, ppt_url, and ai_page_html. Status semantics are shared with PPT Task API.

오류 코드

Code	HTTP Status	설명
`INVALID_API_KEY`	401	API Key is invalid or revoked
`LANDING_PAGE_TASK_CREATE_FAILED`	502	Landing page task creation failed
`INSUFFICIENT_CREDITS`	402	Insufficient credits available