Felo APIs

Mindmap API

Buat mindmap dari prompt dan konteks LiveDoc opsional.

POST/v2/mindmap

Autentikasi

Bearer API key

Tipe konten

application/json

Catatan batas laju

Batas khusus endpoint dapat berlaku.

LiveDoc API

Mindmap API menyediakan kemampuan pembuatan mindmap. Anda dapat membuat mindmap dengan topik atau pertanyaan, dan secara opsional menentukan jenis tata letak.

Autentikasi

Semua permintaan memerlukan kunci API di header Authorization:

Authorization: Bearer YOUR_API_KEY

Penggunaan dengan Agen AI

Instal paket felo-ai lengkap agar Agen dapat membuat mindmap bersama setiap Felo Skill lain yang tersedia. Penginstal secara dinamis menemukan setiap direktori paket yang berisi SKILL.md, sehingga mencakup penambahan mendatang. Instal semua Skill yang ditemukan di Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills, atau Hermes Agent ~/.hermes/skills. Ikuti panduan penyiapan Agen AI manual untuk prosedur penyiapan yang aman bagi setiap platform.

Membuat Mindmap

Buat mindmap berdasarkan kueri (topik atau pertanyaan).

Endpoint

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

Header Permintaan

Header	Wajib	Deskripsi
`Authorization`	Ya	Kunci API Anda dalam format `Bearer YOUR_API_KEY`
`Content-Type`	Ya	Harus `application/json`

Isi Permintaan

Parameter	Tipe	Wajib	Deskripsi
`query`	string	Ya	Topik atau pertanyaan untuk pembuatan mindmap. Maks 2000 karakter
`layout`	string	Tidak	Jenis tata letak. Default: `MIND_MAP`
`livedoc_short_id`	string	Tidak	ID LiveDoc. Jika tidak disediakan, LiveDoc baru akan dibuat secara otomatis

Jenis Tata Letak

Tata letak	Deskripsi
`MIND_MAP`	Mind map klasik (default)
`LOGICAL_STRUCTURE`	Diagram struktur logis
`ORGANIZATION_STRUCTURE`	Bagan organisasi
`CATALOG_ORGANIZATION`	Bagan organisasi katalog
`TIMELINE`	Diagram garis waktu
`FISHBONE`	Diagram tulang ikan

Contoh: Membuat dengan LiveDoc Otomatis

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

Contoh: Membuat dengan LiveDoc Tertentu

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

Respons Berhasil (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"
  }
}

Field Respons

Field	Tipe	Deskripsi
`resource_id`	string	ID resource mindmap yang dibuat
`status`	string	Status mindmap (misalnya, `COMPLETED`)
`livedoc_short_id`	string	ID pendek LiveDoc tempat mindmap disimpan
`mindmap_url`	string	URL untuk melihat mindmap (format: `{host}/mindmap/{resource_id}`)
`svg`	string	Konten SVG mindmap
`message`	string	Pesan status

Kode Error

Kode	Status HTTP	Deskripsi
`UNAUTHORIZED`	401	Kunci API tidak valid atau dicabut
`MINDMAP_CREATE_FAILED`	502	Pembuatan mindmap gagal
`LIVEDOC_CREATE_FAILED`	502	Gagal membuat LiveDoc
`LIVEDOC_NOT_FOUND`	404	LiveDoc yang ditentukan tidak ditemukan
`LLM_SERVICE_UNAVAILABLE`	503	Layanan LLM tidak tersedia
`LLM_REQUEST_TIMEOUT`	504	Permintaan LLM melewati batas waktu