Felo API PlatformFelo API Platform

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.

Questa pagina documenta le API Felo esistenti /v2, usando le entitlements dell'account Felo e le regole dei crediti Pro. Se i crediti vengono scalati dipende dall'operazione. Per le chiamate con saldo della piattaforma, scegli un endpoint Felo OpenAPI supportato; le forme di richiesta e risposta possono differire.

La Landing Page Task API fornisce funzionalità asincrone di generazione landing page. Prima crei un task, poi riutilizzi le API di polling del task esistenti per interrogare avanzamento e risultati.

Usa con gli AI Agent

Installa il pacchetto completo felo-ai per consentire a un Agent di generare landing page e usare ogni altra Felo Skill disponibile. L'installer scopre dinamicamente ogni directory di pacchetto che contiene SKILL.md, invece di affidarsi a un elenco fisso. Installa tutte le Skill scoperte in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills o Hermes Agent ~/.hermes/skills. Leggi la guida manuale alla configurazione dell'AI Agent per i passaggi specifici della piattaforma su API key e verifica.

Autenticazione

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

Authorization: Bearer YOUR_API_KEY

Crea task Landing Page

Endpoint

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

Header della richiesta

HeaderObbligatorioDescrizione
AuthorizationSìLa tua API Key nel formato Bearer YOUR_API_KEY
Content-TypeSìapplication/json o multipart/form-data

Body della richiesta

ParametroTipoObbligatorioDescrizione
querystringSìPrompt della richiesta di generazione della landing page
stream_protocolstringNoProtocollo di stream. Predefinito: message_center_v1
livedoc_short_idstringNoShort ID LiveDoc esistente da usare come contesto
resource_idsarray di stringheNoID risorsa 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"
  }'

Crea con file

Usa multipart/form-data per caricare un file insieme alla richiesta del task Landing Page. Il file viene caricato prima come risorsa LiveDoc, poi il suo ID risorsa viene passato al task 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 opzionali:

ParametroTipoObbligatorioDescrizione
stream_protocolstringNoProtocollo di stream. Predefinito: message_center_v1
livedoc_short_idstringNoShort ID LiveDoc esistente. Se omesso, viene creato un nuovo LiveDoc

Risposta di successo (200)

{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9"
  }
}

Campi della risposta

CampoTipoDescrizione
task_idstringIdentificatore del task asincrono per il polling successivo

Interroga lo stato del task

I task Landing Page riutilizzano le stesse API di polling del task dei 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'

Interroga le informazioni storiche del task

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 completata AI_PAGE

{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "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://api-ext-index-file.felo.ai/html/address?message_id=9qiLTmT77fA3aVurrMHvRJ"
  }
}

Consulta la PPT Task API per gli esempi di risposta di polling condivisi e la semantica degli stati.

Codici di errore

CodiceStato HTTPDescrizione
INVALID_API_KEY401La API Key è non valida o revocata
LANDING_PAGE_TASK_CREATE_FAILED502Creazione del task della landing page fallita
INSUFFICIENT_CREDITS402Crediti insufficienti disponibili

Serve aiuto?