Felo API PlatformFelo API Platform

Felo APIs

Mindmap API

Erstellen Sie Mindmaps aus Prompts und optionalem LiveDoc-Kontext.

POST/v2/mindmap

Authentifizierung

Bearer API key

Inhaltstyp

application/json

Hinweise zu Limits

Es können endpoint-spezifische Limits gelten.

Die Mindmap API bietet Funktionen zur Mindmap-Generierung. Sie können eine Mindmap zu einem Thema oder einer Frage erstellen und optional einen Layouttyp angeben.

Authentifizierung

Alle Anfragen erfordern einen API-Schlüssel im Authorization-Header:

Authorization: Bearer YOUR_API_KEY

Verwendung mit KI-Agenten

Installieren Sie das vollständige Paket felo-ai, damit ein Agent Mindmaps zusammen mit jedem anderen verfügbaren Felo-Skill erstellen kann. Der Installer ermittelt dynamisch jedes Paketverzeichnis mit SKILL.md und berücksichtigt daher auch künftige Ergänzungen. Installieren Sie alle gefundenen Skills in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills oder Hermes Agent ~/.hermes/skills. Folgen Sie der manuellen Einrichtungsanleitung für KI-Agenten, um die sichere Einrichtung für jede Plattform vorzunehmen.

Mindmap erstellen

Erstellen Sie eine Mindmap auf Basis einer Abfrage (Thema oder Frage).

Endpoint

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

Anfrage-Header

HeaderErforderlichBeschreibung
AuthorizationJaIhr API-Schlüssel im Format Bearer YOUR_API_KEY
Content-TypeJaMuss application/json sein

Anfrage-Textkörper

ParameterTypErforderlichBeschreibung
querystringJaDas Thema oder die Frage für die Mindmap-Generierung. Maximal 2000 Zeichen
layoutstringNeinLayouttyp. Standard: MIND_MAP
livedoc_short_idstringNeinLiveDoc-ID. Wenn nicht angegeben, wird automatisch ein neues LiveDoc erstellt

Layouttypen

LayoutBeschreibung
MIND_MAPKlassische Mindmap (Standard)
LOGICAL_STRUCTURELogisches Strukturdiagramm
ORGANIZATION_STRUCTUREOrganigramm
CATALOG_ORGANIZATIONKatalog-Organigramm
TIMELINEZeitstrahl-Diagramm
FISHBONEFischgräten-Diagramm

Beispiel: Mit automatischem LiveDoc erstellen

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

Beispiel: Mit bestimmtem LiveDoc erstellen

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

Erfolgreiche Antwort (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"
  }
}

Antwortfelder

FeldTypBeschreibung
resource_idstringRessourcen-ID der erstellten Mindmap
statusstringStatus der Mindmap (z. B. COMPLETED)
livedoc_short_idstringKurz-ID des LiveDocs, in dem die Mindmap gespeichert ist
mindmap_urlstringURL zum Anzeigen der Mindmap (Format: {host}/mindmap/{resource_id})
svgstringSVG-Inhalt der Mindmap
messagestringStatusmeldung

Fehlercodes

CodeHTTP-StatusBeschreibung
UNAUTHORIZED401Der API-Schlüssel ist ungültig oder widerrufen
MINDMAP_CREATE_FAILED502Die Erstellung der Mindmap ist fehlgeschlagen
LIVEDOC_CREATE_FAILED502Das LiveDoc konnte nicht erstellt werden
LIVEDOC_NOT_FOUND404Das angegebene LiveDoc wurde nicht gefunden
LLM_SERVICE_UNAVAILABLE503Der LLM-Dienst ist nicht verfügbar
LLM_REQUEST_TIMEOUT504Zeitüberschreitung bei der LLM-Anfrage