Felo APIs
Mindmap API
Crie mindmaps a partir de prompts e de contexto LiveDoc opcional.
/v2/mindmapAutenticaçã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_KEYUso 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/mindmapCabeçalhos da requisição
| Cabeçalho | Obrigatório | Descrição |
|---|---|---|
Authorization | Sim | Sua chave de API no formato Bearer YOUR_API_KEY |
Content-Type | Sim | Deve ser application/json |
Corpo da requisição
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | O tema ou a pergunta para a geração do mapa mental. Máximo de 2000 caracteres |
layout | string | Não | Tipo de layout. Padrão: MIND_MAP |
livedoc_short_id | string | Não | ID do LiveDoc. Se não for informado, um novo LiveDoc será criado automaticamente |
Tipos de layout
| Layout | Descrição |
|---|---|
MIND_MAP | Mapa mental clássico (padrão) |
LOGICAL_STRUCTURE | Diagrama de estrutura lógica |
ORGANIZATION_STRUCTURE | Organograma |
CATALOG_ORGANIZATION | Organograma de catálogo |
TIMELINE | Linha do tempo |
FISHBONE | Diagrama 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
| Campo | Tipo | Descrição |
|---|---|---|
resource_id | string | ID de recurso do mapa mental criado |
status | string | Status do mapa mental (por exemplo, COMPLETED) |
livedoc_short_id | string | Short ID do LiveDoc em que o mapa mental está armazenado |
mindmap_url | string | URL para visualizar o mapa mental (formato: {host}/mindmap/{resource_id}) |
svg | string | Conteúdo SVG do mapa mental |
message | string | Mensagem de status |
Códigos de erro
| Código | Status HTTP | Descrição |
|---|---|---|
UNAUTHORIZED | 401 | A chave de API é inválida ou foi revogada |
MINDMAP_CREATE_FAILED | 502 | A criação do mapa mental falhou |
LIVEDOC_CREATE_FAILED | 502 | Falha ao criar o LiveDoc |
LIVEDOC_NOT_FOUND | 404 | O LiveDoc especificado não foi encontrado |
LLM_SERVICE_UNAVAILABLE | 503 | O serviço de LLM está indisponível |
LLM_REQUEST_TIMEOUT | 504 | A requisição ao LLM excedeu o tempo limite |