Felo API PlatformFelo API Platform

Felo APIs

Mindmap API

Generujte myšlenkové mapy z promptu a volitelného kontextu LiveDoc.

POST/v2/mindmap

Ověřování

Bearer API key

Typ obsahu

application/json

Poznámky k limitům

Mohou platit limity pro jednotlivé endpointy.

Mindmap API poskytuje možnosti generování mindmap. Můžete vytvořit mindmapu s tématem nebo otázkou a volitelně určit typ rozvržení.

Ověřování

Všechny požadavky vyžadují API klíč v hlavičce Authorization:

Authorization: Bearer YOUR_API_KEY

Použití s AI agenty

Nainstalujte kompletní balíček felo-ai, aby agent mohl vytvářet mindmapy vedle všech ostatních dostupných Felo Skills. Instalátor dynamicky objevuje každý adresář balíčku obsahující SKILL.md, takže zahrnuje i budoucí přírůstky. Nainstalujte všechny objevené Skills do ~/.codex/skills pro Codex, ~/.claude/skills pro Claude Code, ~/.agents/skills pro OpenClaw nebo ~/.hermes/skills pro Hermes Agent. Postupujte podle příručky k ručnímu nastavení AI agenta, kde najdete bezpečný postup nastavení pro každou platformu.

Vytvoření mindmapy

Vytvořte mindmapu na základě dotazu (téma nebo otázka).

Endpoint

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

Hlavičky požadavku

HlavičkaPovinnéPopis
AuthorizationAnoVáš API klíč ve formátu Bearer YOUR_API_KEY
Content-TypeAnoMusí být application/json

Tělo požadavku

ParametrTypPovinnéPopis
querystringAnoTéma nebo otázka pro generování mindmapy. Max. 2000 znaků
layoutstringNeTyp rozvržení. Výchozí: MIND_MAP
livedoc_short_idstringNeID LiveDocu. Pokud není uvedeno, automaticky se vytvoří nový LiveDoc

Typy rozvržení

RozvrženíPopis
MIND_MAPKlasická myšlenková mapa (výchozí)
LOGICAL_STRUCTUREDiagram logické struktury
ORGANIZATION_STRUCTUREOrganizační schéma
CATALOG_ORGANIZATIONOrganizační schéma katalogu
TIMELINEČasová osa
FISHBONEDiagram rybí kosti

Příklad: vytvoření s automatickým LiveDocem

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

Příklad: vytvoření s konkrétním LiveDocem

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

Úspěšná odpověď (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"
  }
}

Pole odpovědi

PoleTypPopis
resource_idstringID zdroje vytvořené mindmapy
statusstringStav mindmapy (např. COMPLETED)
livedoc_short_idstringKrátké ID LiveDocu, kde je mindmapa uložena
mindmap_urlstringURL pro zobrazení mindmapy (formát: {host}/mindmap/{resource_id})
svgstringObsah SVG mindmapy
messagestringZpráva o stavu

Kódy chyb

KódStav HTTPPopis
UNAUTHORIZED401API klíč je neplatný nebo zrušený
MINDMAP_CREATE_FAILED502Vytvoření mindmapy selhalo
LIVEDOC_CREATE_FAILED502Vytvoření LiveDocu selhalo
LIVEDOC_NOT_FOUND404Zadaný LiveDoc nebyl nalezen
LLM_SERVICE_UNAVAILABLE503Služba LLM je nedostupná
LLM_REQUEST_TIMEOUT504Požadavek na LLM vypršel