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.

La Mindmap API offre capacità di generazione di mappe mentali. Puoi creare una mappa mentale con un argomento o una domanda e, facoltativamente, specificare un tipo di layout.

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 creare mappe mentali insieme a ogni altra Felo Skill disponibile. L'installer individua dinamicamente ogni directory del pacchetto che contiene SKILL.md, quindi include anche le aggiunte future. Installa tutte le Skill trovate in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills o Hermes Agent ~/.hermes/skills. Segui la guida alla configurazione manuale degli agenti IA per la procedura sicura su ogni piattaforma.

Creare una mappa mentale

Crea una mappa mentale basata su una query (argomento o domanda).

Endpoint

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

Header della richiesta

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

Corpo della richiesta

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

Tipi di layout

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

Esempio: creare 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: creare con un 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": "ok",
  "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",
    "svg": "<svg>...</svg>",
    "message": "Mindmap created successfully"
  }
}

Campi della risposta

CampoTipoDescrizione
resource_idstringID risorsa della mappa mentale creata
statusstringStato della mappa mentale (ad es. COMPLETED)
livedoc_short_idstringID breve del LiveDoc in cui è salvata la mappa mentale
mindmap_urlstringURL per visualizzare la mappa mentale (formato: {host}/mindmap/{resource_id})
svgstringContenuto SVG della mappa mentale
messagestringMessaggio di stato

Codici di errore

CodiceStato HTTPDescrizione
UNAUTHORIZED401La chiave API non è valida o è revocata
MINDMAP_CREATE_FAILED502Creazione della mappa mentale non riuscita
LIVEDOC_CREATE_FAILED502Creazione del LiveDoc non riuscita
LIVEDOC_NOT_FOUND404LiveDoc specificato non trovato
LLM_SERVICE_UNAVAILABLE503Il servizio LLM non è disponibile
LLM_REQUEST_TIMEOUT504Timeout della richiesta LLM