Felo APIs

Landing Page Task API

Genereer landing pages asynchroon en bevraag de taakgeschiedenis.

POST/v2/landing_page

Authenticatie

Bearer API key

Inhoudstype

application/json or multipart/form-data

Toelichting op limieten

Er kunnen limieten gelden die specifiek zijn voor het endpoint.

PPT Task API LiveDoc API

De Landing Page Task API biedt de mogelijkheid om asynchroon landingpagina's te genereren. Je maakt eerst een taak aan en gebruikt daarna de bestaande polling-API's voor taken om de voortgang en resultaten op te vragen.

Authenticatie

Alle verzoeken vereisen een API-sleutel in de Authorization-header:

Authorization: Bearer YOUR_API_KEY

Gebruik met AI-agents

Installeer het volledige pakket felo-ai om een agent landingpagina's te laten genereren en alle andere beschikbare Felo Skills te laten gebruiken. Het installatieprogramma ontdekt dynamisch elke pakketmap die SKILL.md bevat, in plaats van te vertrouwen op een vaste lijst. Installeer alle gevonden Skills in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills of Hermes Agent ~/.hermes/skills. Lees de handleiding voor handmatige AI-agentconfiguratie voor de platformspecifieke API-sleutel en verificatiestappen.

Een landingpaginataak maken

Endpoint

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

Verzoekheaders

Header	Verplicht	Beschrijving
`Authorization`	Ja	Je API-sleutel in de vorm `Bearer YOUR_API_KEY`
`Content-Type`	Ja	`application/json` of `multipart/form-data`

Verzoekbody

Parameter	Type	Verplicht	Beschrijving
`query`	string	Ja	Prompt voor het genereren van de landingpagina
`stream_protocol`	string	Nee	Streamprotocol. Standaard: `message_center_v1`
`livedoc_short_id`	string	Nee	Korte ID van een bestaande LiveDoc om als context te gebruiken
`resource_ids`	array van strings	Nee	Resource-ID's van LiveDocs om als context te gebruiken

Voorbeeld

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

Maken met een bestand

Gebruik multipart/form-data om één bestand met het verzoek voor de landingpaginataak te uploaden. Het bestand wordt eerst als LiveDoc-resource geüpload en daarna wordt het resource-ID doorgegeven aan de landingpaginataak.

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

Optionele multipart-onderdelen:

Parameter	Type	Verplicht	Beschrijving
`stream_protocol`	string	Nee	Streamprotocol. Standaard: `message_center_v1`
`livedoc_short_id`	string	Nee	Korte ID van een bestaande LiveDoc. Als je dit weglaat, wordt een nieuwe LiveDoc aangemaakt

Succesrespons (200)

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

Responsvelden

Veld	Type	Beschrijving
`task_id`	string	Identificatie van de asynchrone taak voor later pollen

De taakstatus pollen

Landingpaginataken gebruiken dezelfde polling-API's voor taken als PPT-taken.

Endpoint

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

Voorbeeld

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'

Historische taakinformatie opvragen

Endpoint

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

Voorbeeld

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'

Voorbeeld van een voltooide AI_PAGE-respons

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

Zie de PPT Task API voor de gedeelde voorbeelden van pollresponsen en de betekenis van statussen.

Foutcodes

Code	HTTP-status	Beschrijving
`UNAUTHORIZED`	401	API-sleutel is ongeldig of ingetrokken
`LANDING_PAGE_TASK_CREATE_FAILED`	502	Het maken van de landingpaginataak is mislukt
`INSUFFICIENT_CREDITS`	402	Onvoldoende service-tegoed beschikbaar