Felo APIs
Mindmap API
Генеруйте інтелект-карти з промпту й необов’язкового контексту LiveDoc.
/v2/mindmapАвтентифікація
Bearer API key
Тип вмісту
application/json
Примітки щодо обмежень
Можуть діяти обмеження для окремих endpoint.
Mindmap API надає можливості генерації інтелект-карт. Ви можете створити інтелект-карту за темою або запитанням і за бажанням указати тип компонування.
Автентифікація
Усі запити потребують API-ключа в заголовку Authorization:
Authorization: Bearer YOUR_API_KEYВикористання з агентами ШІ
Установіть повний пакет felo-ai, щоб агент міг створювати інтелект-карти разом з усіма іншими доступними Felo Skills. Інсталятор динамічно знаходить кожен каталог пакета, що містить SKILL.md, тому враховує майбутні доповнення. Установіть усі знайдені Skills у Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills або Hermes Agent ~/.hermes/skills. Дотримуйтеся посібника з ручного налаштування агента ШІ, щоб дізнатися про безпечну процедуру налаштування для кожної платформи.
Створити інтелект-карту
Створіть інтелект-карту на основі запиту (теми або запитання).
Endpoint
POST https://openapi.felo.ai/v2/mindmapЗаголовки запиту
| Заголовок | Обов'язковий | Опис |
|---|---|---|
Authorization | Так | Ваш API-ключ у форматі Bearer YOUR_API_KEY |
Content-Type | Так | Має бути application/json |
Тіло запиту
| Параметр | Тип | Обов'язковий | Опис |
|---|---|---|---|
query | string | Так | Тема або запитання для генерації інтелект-карти. До 2000 символів |
layout | string | Ні | Тип компонування. За замовчуванням: MIND_MAP |
livedoc_short_id | string | Ні | ID LiveDoc. Якщо не вказано, новий LiveDoc буде створено автоматично |
Типи компонування
| Компонування | Опис |
|---|---|
MIND_MAP | Класична інтелект-карта (за замовчуванням) |
LOGICAL_STRUCTURE | Діаграма логічної структури |
ORGANIZATION_STRUCTURE | Організаційна схема |
CATALOG_ORGANIZATION | Каталожна організаційна схема |
TIMELINE | Діаграма часової шкали |
FISHBONE | Діаграма Ісікави |
Приклад: створення з автоматичним 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"
}'Приклад: створення з конкретним 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"
}'Успішна відповідь (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"
}
}Поля відповіді
| Поле | Тип | Опис |
|---|---|---|
resource_id | string | ID ресурсу створеної інтелект-карти |
status | string | Статус інтелект-карти (напр., COMPLETED) |
livedoc_short_id | string | Короткий ID LiveDoc, де збережено інтелект-карту |
mindmap_url | string | URL-адреса для перегляду інтелект-карти (формат: {host}/mindmap/{resource_id}) |
svg | string | Вміст SVG інтелект-карти |
message | string | Повідомлення про статус |
Коди помилок
| Код | Статус HTTP | Опис |
|---|---|---|
UNAUTHORIZED | 401 | API-ключ недійсний або відкликаний |
MINDMAP_CREATE_FAILED | 502 | Не вдалося створити інтелект-карту |
LIVEDOC_CREATE_FAILED | 502 | Не вдалося створити LiveDoc |
LIVEDOC_NOT_FOUND | 404 | Вказаний LiveDoc не знайдено |
LLM_SERVICE_UNAVAILABLE | 503 | Сервіс LLM недоступний |
LLM_REQUEST_TIMEOUT | 504 | Час очікування запиту до LLM вичерпано |