Настройка Harness

Landing Page Task API

Генерируйте landing pages асинхронно и запрашивайте 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. Сначала создайте 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

Тело запроса

Параметр	Тип	Обязательный	Описание
`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