Felo API PlatformFelo API Platform

Felo APIs

Mindmap API

Crea mappe mentali da prompt e da contesto LiveDoc opzionale.

POST/v2/mindmap

Autenticazione

Bearer API key

Tipo di contenuto

application/json

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 Mindmap API fornisce funzionalità di generazione di mindmap. Puoi creare una mindmap con un argomento o una domanda, e specificare facoltativamente un tipo di layout.

Usa con gli AI Agent

Installa il pacchetto completo felo-ai per consentire a un Agent di creare mindmap insieme a ogni altra Felo Skill disponibile. L'installer scopre dinamicamente ogni directory di pacchetto che contiene SKILL.md, quindi include aggiunte future. Installa tutte le Skill scoperte in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills o Hermes Agent ~/.hermes/skills. Segui la guida manuale alla configurazione dell'AI Agent per la procedura sicura di configurazione per ciascuna piattaforma.

Autenticazione

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

Authorization: Bearer YOUR_API_KEY

Crea mindmap

Crea una mindmap basata su una query (argomento o domanda).

Endpoint

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

Header della richiesta

HeaderObbligatorioDescrizione
AuthorizationSìLa tua API Key nel formato Bearer YOUR_API_KEY
Content-TypeSìDeve essere application/json

Body della richiesta

ParametroTipoObbligatorioDescrizione
querystringSìL'argomento o la domanda per la generazione della mindmap. Massimo 2000 caratteri
layoutstringNoTipo di layout. Predefinito: MIND_MAP
livedoc_short_idstringNoID LiveDoc. Se non fornito, verrà creato automaticamente un nuovo LiveDoc

Tipi di layout

LayoutDescrizione
MIND_MAPMind map classica (predefinita)
LOGICAL_STRUCTUREDiagramma di struttura logica
ORGANIZATION_STRUCTUREOrganigramma
CATALOG_ORGANIZATIONOrganigramma a catalogo
TIMELINEDiagramma temporale
FISHBONEDiagramma a lisca di pesce

Esempio: crea con LiveDoc automatico

curl -X POST 'https://openapi.felo.ai/v2/mindmap' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Artificial Intelligence trends in 2024"
  }'

Esempio: crea con LiveDoc specifico

curl -X POST 'https://openapi.felo.ai/v2/mindmap' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Project timeline overview",
    "layout": "TIMELINE",
    "livedoc_short_id": "abc123xyz"
  }'

Risposta di successo (200)

{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": {
    "resource_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "COMPLETED",
    "livedoc_short_id": "PvyKouzJirXjFdst4uKRK3",
    "mindmap_url": "https://felo.ai/mindmap/550e8400-e29b-41d4-a716-446655440000",
    "message": "Mindmap created successfully"
  }
}

Campi della risposta

CampoTipoDescrizione
resource_idstringID della risorsa della mindmap creata
statusstringStato della mindmap (ad es. COMPLETED)
livedoc_short_idstringShort ID LiveDoc in cui la mindmap è archiviata
mindmap_urlstringURL per visualizzare la mindmap (formato: {host}/mindmap/{resource_id})
svgstring | nullSVG opzionale, presente solo quando il generatore lo fornisce; può essere omesso
messagestringMessaggio di stato

Leggi la struttura della mindmap

Usa data.livedoc_short_id e data.resource_id per leggere la risorsa mindmap salvata:

curl 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/550e8400-e29b-41d4-a716-446655440000/content' \
  -H 'Authorization: Bearer YOUR_API_KEY'

La risposta della risorsa ha data.type: "mindmap". Analizza data.content come JSON per ottenere la struttura:

{
  "layout": "mindMap",
  "text": "# Topic\n## Branch\n### Leaf"
}

text usa intestazioni Markdown per rappresentare la gerarchia. Il valore layout salvato è un valore del renderer (ad esempio mindMap); i valori di layout della richiesta usano i nomi in maiuscolo elencati sopra. Le applicazioni possono renderizzare questa struttura o aprire il mindmap_url restituito.

Codici di errore

CodiceStato HTTPDescrizione
INVALID_API_KEY401La API Key è non valida o revocata
MINDMAP_CREATE_FAILED502Creazione della mindmap fallita
LIVEDOC_CREATE_FAILED502Creazione del LiveDoc fallita
LIVEDOC_NOT_FOUND404Il LiveDoc specificato non è stato trovato
LLM_SERVICE_UNAVAILABLE503Il servizio LLM non è disponibile
LLM_REQUEST_TIMEOUT504Timeout della richiesta LLM

Serve aiuto?