Felo APIs
Mindmap API
Crea mapas mentales a partir de prompts y de contexto LiveDoc opcional.
/v2/mindmapAutenticación
Bearer API key
Tipo de contenido
application/json
Notas sobre límites
Pueden aplicarse límites específicos del endpoint.
La Mindmap API ofrece capacidades de generación de mapas mentales. Puedes crear un mapa mental con un tema o una pregunta y, opcionalmente, especificar un tipo de diseño.
Autenticación
Todas las solicitudes requieren una clave de API en el encabezado Authorization:
Authorization: Bearer YOUR_API_KEYUso con agentes de IA
Instala el paquete completo felo-ai para que un agente pueda crear mapas mentales junto con todas las demás Felo Skills disponibles. El instalador descubre dinámicamente todos los directorios del paquete que contengan SKILL.md, por lo que incluye las incorporaciones futuras. Instala todas las Skills descubiertas en Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills o Hermes Agent ~/.hermes/skills. Sigue la guía de configuración manual de agentes de IA para conocer el procedimiento de configuración seguro de cada plataforma.
Crear un mapa mental
Crea un mapa mental a partir de una consulta (tema o pregunta).
Endpoint
POST https://openapi.felo.ai/v2/mindmapEncabezados de la solicitud
| Encabezado | Obligatorio | Descripción |
|---|---|---|
Authorization | Sí | Tu clave de API con el formato Bearer YOUR_API_KEY |
Content-Type | Sí | Debe ser application/json |
Cuerpo de la solicitud
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
query | string | Sí | El tema o la pregunta para generar el mapa mental. Máximo 2000 caracteres |
layout | string | No | Tipo de diseño. Predeterminado: MIND_MAP |
livedoc_short_id | string | No | ID de LiveDoc. Si no se indica, se creará un nuevo LiveDoc automáticamente |
Tipos de diseño
| Diseño | Descripción |
|---|---|
MIND_MAP | Mapa mental clásico (predeterminado) |
LOGICAL_STRUCTURE | Diagrama de estructura lógica |
ORGANIZATION_STRUCTURE | Organigrama |
CATALOG_ORGANIZATION | Organigrama de catálogo |
TIMELINE | Diagrama de línea de tiempo |
FISHBONE | Diagrama de espina de pescado |
Ejemplo: crear con LiveDoc automático
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"
}'Ejemplo: crear con un LiveDoc específico
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"
}'Respuesta correcta (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"
}
}Campos de la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
resource_id | string | ID de recurso del mapa mental creado |
status | string | Estado del mapa mental (por ejemplo, COMPLETED) |
livedoc_short_id | string | ID corto del LiveDoc donde se almacena el mapa mental |
mindmap_url | string | URL para ver el mapa mental (formato: {host}/mindmap/{resource_id}) |
svg | string | Contenido SVG del mapa mental |
message | string | Mensaje de estado |
Códigos de error
| Código | Estado HTTP | Descripción |
|---|---|---|
UNAUTHORIZED | 401 | La clave de API no es válida o está revocada |
MINDMAP_CREATE_FAILED | 502 | Falló la creación del mapa mental |
LIVEDOC_CREATE_FAILED | 502 | Falló la creación del LiveDoc |
LIVEDOC_NOT_FOUND | 404 | No se encontró el LiveDoc especificado |
LLM_SERVICE_UNAVAILABLE | 503 | El servicio LLM no está disponible |
LLM_REQUEST_TIMEOUT | 504 | Se agotó el tiempo de espera de la solicitud al LLM |