Felo APIs

Landing Page Task API

Générez des landing pages de façon asynchrone et consultez l'historique des tâches.

POST/v2/landing_page

Authentification

Bearer API key

Type de contenu

application/json or multipart/form-data

Notes sur les limites

Des limites propres à l'endpoint peuvent s'appliquer.

PPT Task API LiveDoc API

L'API Landing Page Task fournit des capacités asynchrones de génération de landing pages. Vous créez d'abord une tâche, puis réutilisez les API d'interrogation de tâches existantes pour consulter la progression et les résultats.

Authentification

Toutes les requêtes nécessitent une clé API dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_KEY

Utilisation avec des agents IA

Installez le paquet complet felo-ai pour permettre à un agent de générer des landing pages et d'utiliser tous les autres Felo Skills disponibles. L'installateur découvre dynamiquement chaque répertoire de paquet contenant SKILL.md, au lieu de s'appuyer sur une liste figée. Installez tous les Skills découverts dans Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills ou Hermes Agent ~/.hermes/skills. Lisez le guide d'installation manuelle des agents IA pour la clé API et les étapes de vérification propres à chaque plateforme.

Créer une tâche de landing page

Endpoint

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

En-têtes de requête

En-tête	Requis	Description
`Authorization`	Oui	Votre clé API au format `Bearer YOUR_API_KEY`
`Content-Type`	Oui	`application/json` ou `multipart/form-data`

Corps de requête

Paramètre	Type	Requis	Description
`query`	string	Oui	Prompt de génération de la landing page
`stream_protocol`	string	Non	Protocole de flux. Par défaut : `message_center_v1`
`livedoc_short_id`	string	Non	ID court d'un LiveDoc existant à utiliser comme contexte
`resource_ids`	array of strings	Non	ID de ressources LiveDoc à utiliser comme contexte

Exemple

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

Créer avec un fichier

Utilisez multipart/form-data pour envoyer un fichier avec la requête de tâche Landing Page. Le fichier est d'abord importé comme ressource LiveDoc, puis son ID de ressource est transmis à la tâche 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]'

Parties multipart facultatives :

Paramètre	Type	Requis	Description
`stream_protocol`	string	Non	Protocole de flux. Par défaut : `message_center_v1`
`livedoc_short_id`	string	Non	ID court d'un LiveDoc existant. S'il est omis, un nouveau LiveDoc est créé

Réponse de succès (200)

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

Champs de réponse

Champ	Type	Description
`task_id`	string	Identifiant de tâche asynchrone pour les interrogations suivantes

Interroger l'état d'une tâche

Les tâches Landing Page réutilisent les mêmes API d'interrogation que les tâches PPT.

Endpoint

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

Exemple

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'

Interroger l'historique d'une tâche

Endpoint

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

Exemple

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'

Exemple de réponse AI_PAGE terminée

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

Reportez-vous à l'API PPT Task pour les exemples de réponses d'interrogation partagés et la sémantique des statuts.

Codes d'erreur

Code	Statut HTTP	Description
`UNAUTHORIZED`	401	La clé API est invalide ou révoquée
`LANDING_PAGE_TASK_CREATE_FAILED`	502	La création de la tâche de landing page a échoué
`INSUFFICIENT_CREDITS`	402	Crédits disponibles insuffisants