Felo API PlatformFelo API Platform

Felo APIs

Mindmap API

Generuj mapy myśli z promptu i opcjonalnego kontekstu LiveDoc.

POST/v2/mindmap

Uwierzytelnianie

Bearer API key

Typ zawartości

application/json

Uwagi o limitach

Mogą obowiązywać limity dla poszczególnych endpointów.

API Mindmap zapewnia możliwości generowania map myśli. Możesz utworzyć mapę myśli na podstawie tematu lub pytania i opcjonalnie określić typ układu.

Uwierzytelnianie

Wszystkie żądania wymagają klucza API w nagłówku Authorization:

Authorization: Bearer YOUR_API_KEY

Użycie z agentami AI

Zainstaluj kompletny pakiet felo-ai, aby agent mógł tworzyć mapy myśli obok każdego innego dostępnego Felo Skill. Instalator dynamicznie wykrywa każdy katalog pakietu zawierający SKILL.md, więc obejmuje przyszłe dodatki. Zainstaluj wszystkie wykryte Skills w Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills lub Hermes Agent ~/.hermes/skills. Postępuj według podręcznika konfiguracji agenta AI, aby poznać bezpieczną procedurę konfiguracji dla każdej platformy.

Tworzenie mapy myśli

Utwórz mapę myśli na podstawie zapytania (tematu lub pytania).

Endpoint

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

Nagłówki żądania

NagłówekWymaganyOpis
AuthorizationTakTwój klucz API w formacie Bearer YOUR_API_KEY
Content-TypeTakMusi mieć wartość application/json

Treść żądania

ParametrTypWymaganyOpis
querystringTakTemat lub pytanie do wygenerowania mapy myśli. Maks. 2000 znaków
layoutstringNieTyp układu. Domyślnie: MIND_MAP
livedoc_short_idstringNieIdentyfikator LiveDoc. Jeśli nie zostanie podany, nowy LiveDoc zostanie utworzony automatycznie

Typy układu

UkładOpis
MIND_MAPKlasyczna mapa myśli (domyślna)
LOGICAL_STRUCTUREDiagram struktury logicznej
ORGANIZATION_STRUCTURESchemat organizacyjny
CATALOG_ORGANIZATIONSchemat organizacji katalogu
TIMELINEDiagram osi czasu
FISHBONEDiagram rybiej ości

Przykład: tworzenie z automatycznym LiveDoc

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

Przykład: tworzenie z konkretnym LiveDoc

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

Odpowiedź sukcesu (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"
  }
}

Pola odpowiedzi

PoleTypOpis
resource_idstringIdentyfikator zasobu utworzonej mapy myśli
statusstringStan mapy myśli (np. COMPLETED)
livedoc_short_idstringKrótki identyfikator LiveDoc, w którym przechowywana jest mapa myśli
mindmap_urlstringAdres URL do wyświetlenia mapy myśli (format: {host}/mindmap/{resource_id})
svgstringZawartość SVG mapy myśli
messagestringKomunikat o stanie

Kody błędów

KodStatus HTTPOpis
UNAUTHORIZED401Klucz API jest nieprawidłowy lub unieważniony
MINDMAP_CREATE_FAILED502Nie udało się utworzyć mapy myśli
LIVEDOC_CREATE_FAILED502Nie udało się utworzyć LiveDoc
LIVEDOC_NOT_FOUND404Nie znaleziono określonego LiveDoc
LLM_SERVICE_UNAVAILABLE503Usługa LLM jest niedostępna
LLM_REQUEST_TIMEOUT504Przekroczono limit czasu żądania LLM