Felo APIs

Mindmap API

Tạo mindmap từ prompt và ngữ cảnh LiveDoc tùy chọn.

POST/v2/mindmap

Xác thực

Bearer API key

Loại nội dung

application/json

Ghi chú về giới hạn

Có thể áp dụng giới hạn riêng cho endpoint.

LiveDoc API

Mindmap API cung cấp khả năng tạo mindmap. Bạn có thể tạo mindmap từ một chủ đề hoặc câu hỏi, và tùy chọn chỉ định loại bố cục.

Xác thực

Mọi yêu cầu đều cần khóa API trong header Authorization:

Authorization: Bearer YOUR_API_KEY

Dùng với AI Agent

Cài gói felo-ai đầy đủ để một Agent có thể tạo mindmap cùng với mọi Felo Skill khác hiện có. Trình cài đặt tự động khám phá mọi thư mục gói có chứa SKILL.md, nên nó bao gồm cả các bổ sung trong tương lai. Hãy cài mọi Skill được phát hiện vào Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills hoặc Hermes Agent ~/.hermes/skills. Làm theo hướng dẫn thiết lập AI Agent thủ công để biết quy trình thiết lập an toàn cho từng nền tảng.

Tạo mindmap

Tạo mindmap dựa trên một truy vấn (chủ đề hoặc câu hỏi).

Endpoint

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

Header yêu cầu

Header	Bắt buộc	Mô tả
`Authorization`	Có	Khóa API của bạn theo định dạng `Bearer YOUR_API_KEY`
`Content-Type`	Có	Phải là `application/json`

Nội dung yêu cầu

Tham số	Kiểu	Bắt buộc	Mô tả
`query`	string	Có	Chủ đề hoặc câu hỏi để tạo mindmap. Tối đa 2000 ký tự
`layout`	string	Không	Loại bố cục. Mặc định: `MIND_MAP`
`livedoc_short_id`	string	Không	ID LiveDoc. Nếu không cung cấp, một LiveDoc mới sẽ được tạo tự động

Các loại bố cục

Bố cục	Mô tả
`MIND_MAP`	Mind map cổ điển (mặc định)
`LOGICAL_STRUCTURE`	Sơ đồ cấu trúc logic
`ORGANIZATION_STRUCTURE`	Sơ đồ tổ chức
`CATALOG_ORGANIZATION`	Sơ đồ tổ chức theo danh mục
`TIMELINE`	Sơ đồ dòng thời gian
`FISHBONE`	Sơ đồ xương cá

Ví dụ: Tạo với LiveDoc tự động

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"
  }'

Ví dụ: Tạo với LiveDoc cụ thể

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"
  }'

Phản hồi thành công (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"
  }
}

Các trường phản hồi

Trường	Kiểu	Mô tả
`resource_id`	string	Resource ID của mindmap đã tạo
`status`	string	Trạng thái của mindmap (ví dụ: `COMPLETED`)
`livedoc_short_id`	string	Short ID của LiveDoc nơi mindmap được lưu
`mindmap_url`	string	URL để xem mindmap (định dạng: `{host}/mindmap/{resource_id}`)
`svg`	string	Nội dung SVG của mindmap
`message`	string	Thông điệp trạng thái

Mã lỗi

Mã	Trạng thái HTTP	Mô tả
`UNAUTHORIZED`	401	Khóa API không hợp lệ hoặc đã bị thu hồi
`MINDMAP_CREATE_FAILED`	502	Tạo mindmap thất bại
`LIVEDOC_CREATE_FAILED`	502	Tạo LiveDoc thất bại
`LIVEDOC_NOT_FOUND`	404	Không tìm thấy LiveDoc đã chỉ định
`LLM_SERVICE_UNAVAILABLE`	503	Dịch vụ LLM không khả dụng
`LLM_REQUEST_TIMEOUT`	504	Yêu cầu LLM hết thời gian chờ