Felo APIs

Landing Page Task API

Generujte vstupní stránky asynchronně a procházejte historii úloh.

POST/v2/landing_page

Ověřování

Bearer API key

Typ obsahu

application/json or multipart/form-data

Poznámky k limitům

Mohou platit limity pro jednotlivé endpointy.

PPT Task API LiveDoc API

Landing Page Task API poskytuje možnosti asynchronního generování landing page. Nejprve vytvoříte úlohu a potom znovu použijete stávající API pro dotazování úloh ke zjištění průběhu a výsledků.

Ověřování

Všechny požadavky vyžadují API klíč v hlavičce Authorization:

Authorization: Bearer YOUR_API_KEY

Použití s AI agenty

Nainstalujte kompletní balíček felo-ai, aby agent mohl generovat landing page a používat všechny ostatní dostupné Felo Skills. Instalátor dynamicky objevuje každý adresář balíčku obsahující SKILL.md, namísto spoléhání na pevný seznam. Nainstalujte všechny objevené Skills do ~/.codex/skills pro Codex, ~/.claude/skills pro Claude Code, ~/.agents/skills pro OpenClaw nebo ~/.hermes/skills pro Hermes Agent. Kroky specifické pro platformu týkající se API klíče a ověření najdete v příručce k ručnímu nastavení AI agenta.

Vytvoření úlohy Landing Page

Endpoint

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

Hlavičky požadavku

Hlavička	Povinné	Popis
`Authorization`	Ano	Váš API klíč ve formátu `Bearer YOUR_API_KEY`
`Content-Type`	Ano	`application/json` nebo `multipart/form-data`

Tělo požadavku

Parametr	Typ	Povinné	Popis
`query`	string	Ano	Prompt pro generování landing page
`stream_protocol`	string	Ne	Protokol streamu. Výchozí: `message_center_v1`
`livedoc_short_id`	string	Ne	Krátké ID existujícího LiveDocu, které se použije jako kontext
`resource_ids`	pole řetězců	Ne	ID zdrojů LiveDocu, která se použijí jako kontext

Příklad

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

Vytvoření se souborem

Pomocí multipart/form-data nahrajte jeden soubor s požadavkem na úlohu Landing Page. Soubor se nejprve nahraje jako zdroj LiveDocu a potom se jeho ID zdroje předá úloze Landing Page.

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

Volitelné části multipart:

Parametr	Typ	Povinné	Popis
`stream_protocol`	string	Ne	Protokol streamu. Výchozí: `message_center_v1`
`livedoc_short_id`	string	Ne	Krátké ID existujícího LiveDocu. Pokud je vynecháno, vytvoří se nový LiveDoc

Úspěšná odpověď (200)

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

Pole odpovědi

Pole	Typ	Popis
`task_id`	string	Identifikátor asynchronní úlohy pro následné dotazování

Dotazování stavu úlohy

Úlohy Landing Page znovu používají stejná API pro dotazování úloh jako úlohy PPT.

Endpoint

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

Příklad

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'

Dotazování historických informací o úloze

Endpoint

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

Příklad

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'

Příklad odpovědi AI_PAGE po dokončení

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

Sdílené příklady odpovědí při dotazování a sémantiku stavů najdete v části PPT Task API.

Kódy chyb

Kód	Stav HTTP	Popis
`UNAUTHORIZED`	401	API klíč je neplatný nebo zrušený
`LANDING_PAGE_TASK_CREATE_FAILED`	502	Vytvoření úlohy landing page selhalo
`INSUFFICIENT_CREDITS`	402	Nedostatek dostupných kreditů