Felo APIs

Landing Page Task API

Genera landing page in modo asincrono e consulta la cronologia delle attività.

POST/v2/landing_page

Autenticazione

Bearer API key

Tipo di contenuto

application/json or multipart/form-data

Note sui limiti

Possono applicarsi limiti specifici dell'endpoint.

PPT Task API LiveDoc API

La Landing Page Task API offre capacità asincrone di generazione di landing page. Crea prima un'attività, poi riutilizza le API di polling delle attività esistenti per consultare avanzamento e risultati.

Autenticazione

Tutte le richieste richiedono una chiave API nell'header Authorization:

Authorization: Bearer YOUR_API_KEY

Uso con agenti IA

Installa il pacchetto completo felo-ai per permettere a un agente di generare landing page e usare ogni altra Felo Skill disponibile. L'installer individua dinamicamente ogni directory del pacchetto che contiene SKILL.md, invece di basarsi su un elenco fisso. Installa tutte le Skill trovate in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills o Hermes Agent ~/.hermes/skills. Leggi la guida alla configurazione manuale degli agenti IA per i passaggi di configurazione della chiave API e di verifica su ogni piattaforma.

Creare un'attività di landing page

Endpoint

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

Header della richiesta

Header	Obbligatorio	Descrizione
`Authorization`	Sì	La tua chiave API nel formato `Bearer YOUR_API_KEY`
`Content-Type`	Sì	`application/json` o `multipart/form-data`

Corpo della richiesta

Parametro	Tipo	Obbligatorio	Descrizione
`query`	string	Sì	Prompt di richiesta per la generazione della landing page
`stream_protocol`	string	No	Protocollo di stream. Predefinito: `message_center_v1`
`livedoc_short_id`	string	No	ID breve di un LiveDoc esistente da usare come contesto
`resource_ids`	array di stringhe	No	ID delle risorse LiveDoc da usare come contesto

Esempio

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

Creare con un file

Usa multipart/form-data per caricare un file insieme alla richiesta di attività Landing Page. Il file viene prima caricato come risorsa LiveDoc, poi il suo ID risorsa viene passato all'attività 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]'

Parti multipart facoltative:

Parametro	Tipo	Obbligatorio	Descrizione
`stream_protocol`	string	No	Protocollo di stream. Predefinito: `message_center_v1`
`livedoc_short_id`	string	No	ID breve di un LiveDoc esistente. Se omesso, viene creato un nuovo LiveDoc

Risposta di successo (200)

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

Campi della risposta

Campo	Tipo	Descrizione
`task_id`	string	Identificatore dell'attività asincrona per il polling successivo

Interrogare lo stato dell'attività

Le attività Landing Page riutilizzano le stesse API di polling delle attività PPT.

Endpoint

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

Esempio

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'

Consultare le informazioni storiche dell'attività

Endpoint

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

Esempio

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'

Esempio di risposta AI_PAGE completata

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

Fai riferimento alla PPT Task API per gli esempi condivisi di risposta al polling e la semantica degli stati.

Codici di errore

Codice	Stato HTTP	Descrizione
`UNAUTHORIZED`	401	La chiave API non è valida o è revocata
`LANDING_PAGE_TASK_CREATE_FAILED`	502	Creazione dell'attività di landing page non riuscita
`INSUFFICIENT_CREDITS`	402	Crediti disponibili insufficienti