Felo APIs

Landing Page Task API

Generieren Sie Landing Pages asynchron und fragen Sie den Aufgabenverlauf ab.

POST/v2/landing_page

Authentifizierung

Bearer API key

Inhaltstyp

application/json or multipart/form-data

Hinweise zu Limits

Es können endpoint-spezifische Limits gelten.

PPT Task API LiveDoc API

Die Landing Page Task API bietet asynchrone Funktionen zur Generierung von Landing Pages. Sie erstellen zuerst eine Aufgabe und verwenden dann die vorhandenen Aufgaben-Abfrage-APIs, um Fortschritt und Ergebnisse abzufragen.

Authentifizierung

Alle Anfragen erfordern einen API-Schlüssel im Authorization-Header:

Authorization: Bearer YOUR_API_KEY

Verwendung mit KI-Agenten

Installieren Sie das vollständige Paket felo-ai, damit ein Agent Landing Pages generieren und jeden anderen verfügbaren Felo-Skill verwenden kann. Der Installer ermittelt dynamisch jedes Paketverzeichnis mit SKILL.md, statt sich auf eine feste Liste zu verlassen. Installieren Sie alle gefundenen Skills in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills oder Hermes Agent ~/.hermes/skills. Lesen Sie die manuelle Einrichtungsanleitung für KI-Agenten für die plattformspezifischen Schritte zu API-Schlüssel und Prüfung.

Landing-Page-Aufgabe erstellen

Endpoint

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

Anfrage-Header

Header	Erforderlich	Beschreibung
`Authorization`	Ja	Ihr API-Schlüssel im Format `Bearer YOUR_API_KEY`
`Content-Type`	Ja	`application/json` oder `multipart/form-data`

Anfrage-Textkörper

Parameter	Typ	Erforderlich	Beschreibung
`query`	string	Ja	Prompt für die Landing-Page-Generierung
`stream_protocol`	string	Nein	Stream-Protokoll. Standard: `message_center_v1`
`livedoc_short_id`	string	Nein	Kurz-ID eines vorhandenen LiveDocs, die als Kontext verwendet wird
`resource_ids`	array of strings	Nein	Ressourcen-IDs von LiveDocs, die als Kontext verwendet werden

Beispiel

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

Mit Datei erstellen

Verwenden Sie multipart/form-data, um eine Datei mit der Anfrage für die Landing-Page-Aufgabe hochzuladen. Die Datei wird zuerst als LiveDoc-Ressource hochgeladen, dann wird ihre Ressourcen-ID an die Landing-Page-Aufgabe übergeben.

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

Optionale Multipart-Teile:

Parameter	Typ	Erforderlich	Beschreibung
`stream_protocol`	string	Nein	Stream-Protokoll. Standard: `message_center_v1`
`livedoc_short_id`	string	Nein	Kurz-ID eines vorhandenen LiveDocs. Wenn nicht angegeben, wird ein neues LiveDoc erstellt

Erfolgreiche Antwort (200)

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

Antwortfelder

Feld	Typ	Beschreibung
`task_id`	string	Kennung der asynchronen Aufgabe für die spätere Abfrage

Aufgabenstatus abfragen

Landing-Page-Aufgaben verwenden dieselben Aufgaben-Abfrage-APIs wie PPT-Aufgaben.

Endpoint

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

Beispiel

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 Informationen zur Aufgabe abfragen

Endpoint

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

Beispiel

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'

Beispiel für eine abgeschlossene AI_PAGE-Antwort

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

Die gemeinsamen Beispiele für Abfrageantworten und die Statusbedeutung finden Sie in der PPT Task API.

Fehlercodes

Code	HTTP-Status	Beschreibung
`UNAUTHORIZED`	401	Der API-Schlüssel ist ungültig oder widerrufen
`LANDING_PAGE_TASK_CREATE_FAILED`	502	Die Erstellung der Landing-Page-Aufgabe ist fehlgeschlagen
`INSUFFICIENT_CREDITS`	402	Nicht genügend Guthaben verfügbar