Felo API PlatformFelo API Platform

Felo APIs

Mindmap API

Crea mapas mentales a partir de prompts y de contexto LiveDoc opcional.

POST/v2/mindmap

Autenticació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_KEY

Uso 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/mindmap

Encabezados de la solicitud

EncabezadoObligatorioDescripción
AuthorizationSíTu clave de API con el formato Bearer YOUR_API_KEY
Content-TypeSíDebe ser application/json

Cuerpo de la solicitud

ParámetroTipoObligatorioDescripción
querystringSíEl tema o la pregunta para generar el mapa mental. Máximo 2000 caracteres
layoutstringNoTipo de diseño. Predeterminado: MIND_MAP
livedoc_short_idstringNoID de LiveDoc. Si no se indica, se creará un nuevo LiveDoc automáticamente

Tipos de diseño

DiseñoDescripción
MIND_MAPMapa mental clásico (predeterminado)
LOGICAL_STRUCTUREDiagrama de estructura lógica
ORGANIZATION_STRUCTUREOrganigrama
CATALOG_ORGANIZATIONOrganigrama de catálogo
TIMELINEDiagrama de línea de tiempo
FISHBONEDiagrama 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

CampoTipoDescripción
resource_idstringID de recurso del mapa mental creado
statusstringEstado del mapa mental (por ejemplo, COMPLETED)
livedoc_short_idstringID corto del LiveDoc donde se almacena el mapa mental
mindmap_urlstringURL para ver el mapa mental (formato: {host}/mindmap/{resource_id})
svgstringContenido SVG del mapa mental
messagestringMensaje de estado

Códigos de error

CódigoEstado HTTPDescripción
UNAUTHORIZED401La clave de API no es válida o está revocada
MINDMAP_CREATE_FAILED502Falló la creación del mapa mental
LIVEDOC_CREATE_FAILED502Falló la creación del LiveDoc
LIVEDOC_NOT_FOUND404No se encontró el LiveDoc especificado
LLM_SERVICE_UNAVAILABLE503El servicio LLM no está disponible
LLM_REQUEST_TIMEOUT504Se agotó el tiempo de espera de la solicitud al LLM