Landing Page Task API

Landing Page Task API надає можливості асинхронної генерації лендінгів. Спершу ви створюєте завдання, а потім використовуєте наявні API опитування завдань, щоб дізнатися про прогрес і результати.

Автентифікація

Усі запити потребують API-ключа в заголовку Authorization:

Authorization: Bearer YOUR_API_KEY

Використання з агентами ШІ

Установіть повний пакет felo-ai, щоб агент міг генерувати лендінги та використовувати кожен інший доступний Felo Skill. Інсталятор динамічно знаходить кожен каталог пакета, що містить SKILL.md, замість того щоб покладатися на фіксований список. Установіть усі знайдені Skills у Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills або Hermes Agent ~/.hermes/skills. Про API-ключ для кожної платформи та кроки перевірки читайте в посібнику з ручного налаштування агента ШІ.

Створити завдання лендінгу

Endpoint

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

Заголовки запиту

Тіло запиту

Приклад

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"
  }'

Створення з файлом

Використовуйте multipart/form-data, щоб завантажити один файл разом із запитом на створення завдання лендінгу. Файл спершу завантажується як ресурс LiveDoc, а потім його ID ресурсу передається завданню лендінгу.

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]'

Необов'язкові частини multipart-запиту:

Успішна відповідь (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9"
  }
}

Поля відповіді

Опитування статусу завдання

Завдання лендінгу використовують ті самі API опитування завдань, що й завдання PPT.

Endpoint

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'

Отримання історії завдання

Endpoint

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

Приклад

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

Приклад відповіді AI_PAGE у стані COMPLETED

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019d7a4d-6ab5-a96d-0f98-43ca434ab621",
    "task_status": "COMPLETED",
    "ppt_biz_id": "9qiLTmT77fA3aVurrMHvRJ",
    "ppt_url": "https://felo.ai/slides/9qiLTmT77fA3aVurrMHvRJ",
    "ai_page_html": "https://felo.ai/ai-page/9qiLTmT77fA3aVurrMHvRJ"
  }
}

Спільні приклади відповідей на опитування та семантику статусів див. у PPT Task API.

Коди помилок