Felo APIs
Mindmap API
Generujte myšlenkové mapy z promptu a volitelného kontextu LiveDoc.
/v2/mindmapOvěř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_KEYPouž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/mindmapHlavičky požadavku
| Hlavička | Povinné | Popis |
|---|---|---|
Authorization | Ano | Váš API klíč ve formátu Bearer YOUR_API_KEY |
Content-Type | Ano | Musí být application/json |
Tělo požadavku
| Parametr | Typ | Povinné | Popis |
|---|---|---|---|
query | string | Ano | Téma nebo otázka pro generování mindmapy. Max. 2000 znaků |
layout | string | Ne | Typ rozvržení. Výchozí: MIND_MAP |
livedoc_short_id | string | Ne | ID LiveDocu. Pokud není uvedeno, automaticky se vytvoří nový LiveDoc |
Typy rozvržení
| Rozvržení | Popis |
|---|---|
MIND_MAP | Klasická myšlenková mapa (výchozí) |
LOGICAL_STRUCTURE | Diagram logické struktury |
ORGANIZATION_STRUCTURE | Organizační schéma |
CATALOG_ORGANIZATION | Organizační schéma katalogu |
TIMELINE | Časová osa |
FISHBONE | Diagram 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
| Pole | Typ | Popis |
|---|---|---|
resource_id | string | ID zdroje vytvořené mindmapy |
status | string | Stav mindmapy (např. COMPLETED) |
livedoc_short_id | string | Krátké ID LiveDocu, kde je mindmapa uložena |
mindmap_url | string | URL pro zobrazení mindmapy (formát: {host}/mindmap/{resource_id}) |
svg | string | Obsah SVG mindmapy |
message | string | Zpráva o stavu |
Kódy chyb
| Kód | Stav HTTP | Popis |
|---|---|---|
UNAUTHORIZED | 401 | API klíč je neplatný nebo zrušený |
MINDMAP_CREATE_FAILED | 502 | Vytvoření mindmapy selhalo |
LIVEDOC_CREATE_FAILED | 502 | Vytvoření LiveDocu selhalo |
LIVEDOC_NOT_FOUND | 404 | Zadaný LiveDoc nebyl nalezen |
LLM_SERVICE_UNAVAILABLE | 503 | Služba LLM je nedostupná |
LLM_REQUEST_TIMEOUT | 504 | Požadavek na LLM vypršel |