Felo APIs
Mindmap API
Generuj mapy myśli z promptu i opcjonalnego kontekstu LiveDoc.
/v2/mindmapUwierzytelnianie
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_KEYUż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/mindmapNagłówki żądania
| Nagłówek | Wymagany | Opis |
|---|---|---|
Authorization | Tak | Twój klucz API w formacie Bearer YOUR_API_KEY |
Content-Type | Tak | Musi mieć wartość application/json |
Treść żądania
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
query | string | Tak | Temat lub pytanie do wygenerowania mapy myśli. Maks. 2000 znaków |
layout | string | Nie | Typ układu. Domyślnie: MIND_MAP |
livedoc_short_id | string | Nie | Identyfikator LiveDoc. Jeśli nie zostanie podany, nowy LiveDoc zostanie utworzony automatycznie |
Typy układu
| Układ | Opis |
|---|---|
MIND_MAP | Klasyczna mapa myśli (domyślna) |
LOGICAL_STRUCTURE | Diagram struktury logicznej |
ORGANIZATION_STRUCTURE | Schemat organizacyjny |
CATALOG_ORGANIZATION | Schemat organizacji katalogu |
TIMELINE | Diagram osi czasu |
FISHBONE | Diagram 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
| Pole | Typ | Opis |
|---|---|---|
resource_id | string | Identyfikator zasobu utworzonej mapy myśli |
status | string | Stan mapy myśli (np. COMPLETED) |
livedoc_short_id | string | Krótki identyfikator LiveDoc, w którym przechowywana jest mapa myśli |
mindmap_url | string | Adres URL do wyświetlenia mapy myśli (format: {host}/mindmap/{resource_id}) |
svg | string | Zawartość SVG mapy myśli |
message | string | Komunikat o stanie |
Kody błędów
| Kod | Status HTTP | Opis |
|---|---|---|
UNAUTHORIZED | 401 | Klucz API jest nieprawidłowy lub unieważniony |
MINDMAP_CREATE_FAILED | 502 | Nie udało się utworzyć mapy myśli |
LIVEDOC_CREATE_FAILED | 502 | Nie udało się utworzyć LiveDoc |
LIVEDOC_NOT_FOUND | 404 | Nie znaleziono określonego LiveDoc |
LLM_SERVICE_UNAVAILABLE | 503 | Usługa LLM jest niedostępna |
LLM_REQUEST_TIMEOUT | 504 | Przekroczono limit czasu żądania LLM |