Felo API PlatformFelo API Platform

Felo APIs

Mindmap API

Генеруйте інтелект-карти з промпту й необов’язкового контексту LiveDoc.

POST/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

Тіло запиту

ПараметрТипОбов'язковийОпис
querystringТакТема або запитання для генерації інтелект-карти. До 2000 символів
layoutstringНіТип компонування. За замовчуванням: MIND_MAP
livedoc_short_idstringНі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_idstringID ресурсу створеної інтелект-карти
statusstringСтатус інтелект-карти (напр., COMPLETED)
livedoc_short_idstringКороткий ID LiveDoc, де збережено інтелект-карту
mindmap_urlstringURL-адреса для перегляду інтелект-карти (формат: {host}/mindmap/{resource_id})
svgstringВміст SVG інтелект-карти
messagestringПовідомлення про статус

Коди помилок

КодСтатус HTTPОпис
UNAUTHORIZED401API-ключ недійсний або відкликаний
MINDMAP_CREATE_FAILED502Не вдалося створити інтелект-карту
LIVEDOC_CREATE_FAILED502Не вдалося створити LiveDoc
LIVEDOC_NOT_FOUND404Вказаний LiveDoc не знайдено
LLM_SERVICE_UNAVAILABLE503Сервіс LLM недоступний
LLM_REQUEST_TIMEOUT504Час очікування запиту до LLM вичерпано