Felo API PlatformFelo API Platform

Felo APIs

Mindmap API

Crie mindmaps a partir de prompts e de contexto LiveDoc opcional.

POST/v2/mindmap

Autenticação

Bearer API key

Tipo de conteúdo

application/json

Notas de limite

Podem se aplicar limites específicos do endpoint.

A Mindmap API oferece recursos de geração de mapas mentais. Você pode criar um mapa mental com um tema ou uma pergunta e, opcionalmente, especificar um tipo de layout.

Autenticação

Todas as requisições exigem uma chave de API no cabeçalho Authorization:

Authorization: Bearer YOUR_API_KEY

Uso com agentes de IA

Instale o pacote completo felo-ai para permitir que um agente crie mapas mentais e use todos os demais Felo Skills disponíveis. O instalador descobre dinamicamente todos os diretórios de pacote que contêm SKILL.md, então inclui adições futuras. Instale todos os Skills descobertos em ~/.codex/skills para o Codex, ~/.claude/skills para o Claude Code, ~/.agents/skills para o OpenClaw ou ~/.hermes/skills para o Hermes Agent. Siga o guia de configuração manual de agentes de IA para ver o procedimento seguro de configuração de cada plataforma.

Criar um mapa mental

Crie um mapa mental com base em uma consulta (tema ou pergunta).

Endpoint

POST https://openapi.felo.ai/v2/mindmap

Cabeçalhos da requisição

CabeçalhoObrigatórioDescrição
AuthorizationSimSua chave de API no formato Bearer YOUR_API_KEY
Content-TypeSimDeve ser application/json

Corpo da requisição

ParâmetroTipoObrigatórioDescrição
querystringSimO tema ou a pergunta para a geração do mapa mental. Máximo de 2000 caracteres
layoutstringNãoTipo de layout. Padrão: MIND_MAP
livedoc_short_idstringNãoID do LiveDoc. Se não for informado, um novo LiveDoc será criado automaticamente

Tipos de layout

LayoutDescrição
MIND_MAPMapa mental clássico (padrão)
LOGICAL_STRUCTUREDiagrama de estrutura lógica
ORGANIZATION_STRUCTUREOrganograma
CATALOG_ORGANIZATIONOrganograma de catálogo
TIMELINELinha do tempo
FISHBONEDiagrama espinha de peixe

Exemplo: criar com 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"
  }'

Exemplo: criar com um 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"
  }'

Resposta de sucesso (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 da resposta

CampoTipoDescrição
resource_idstringID de recurso do mapa mental criado
statusstringStatus do mapa mental (por exemplo, COMPLETED)
livedoc_short_idstringShort ID do LiveDoc em que o mapa mental está armazenado
mindmap_urlstringURL para visualizar o mapa mental (formato: {host}/mindmap/{resource_id})
svgstringConteúdo SVG do mapa mental
messagestringMensagem de status

Códigos de erro

CódigoStatus HTTPDescrição
UNAUTHORIZED401A chave de API é inválida ou foi revogada
MINDMAP_CREATE_FAILED502A criação do mapa mental falhou
LIVEDOC_CREATE_FAILED502Falha ao criar o LiveDoc
LIVEDOC_NOT_FOUND404O LiveDoc especificado não foi encontrado
LLM_SERVICE_UNAVAILABLE503O serviço de LLM está indisponível
LLM_REQUEST_TIMEOUT504A requisição ao LLM excedeu o tempo limite