Felo APIs

Mindmap API

สร้าง mindmap จากพรอมป์ต์และบริบท LiveDoc แบบไม่บังคับ

POST/v2/mindmap

การยืนยันตัวตน

Bearer API key

ประเภทเนื้อหา

application/json

หมายเหตุเรื่องข้อจำกัด

อาจมีข้อจำกัดเฉพาะของ endpoint

LiveDoc API

Mindmap API มอบความสามารถในการสร้างมายด์แมป คุณสามารถสร้างมายด์แมปจากหัวข้อหรือคำถาม และระบุประเภทเลย์เอาต์ได้ตามต้องการ

การรับรองความถูกต้อง

ทุกคำขอต้องมีคีย์ API ใน header Authorization:

Authorization: Bearer YOUR_API_KEY

ใช้กับ AI Agent

ติดตั้งแพ็กเกจ felo-ai ที่ครบถ้วนเพื่อให้ Agent สร้างมายด์แมปพร้อมกับ Felo Skill อื่น ๆ ที่มีให้ใช้ทั้งหมด ตัวติดตั้งจะค้นหาไดเรกทอรีแพ็กเกจทุกไดเรกทอรีที่มี SKILL.md แบบไดนามิก จึงรวมส่วนเพิ่มเติมในอนาคตด้วย ให้ติดตั้ง Skill ทั้งหมดที่ค้นพบใน Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills หรือ Hermes Agent ~/.hermes/skills ปฏิบัติตามคู่มือการตั้งค่า AI Agent ด้วยตนเองสำหรับขั้นตอนการตั้งค่าที่ปลอดภัยของแต่ละแพลตฟอร์ม

สร้างมายด์แมป

สร้างมายด์แมปจากคำถาม (หัวข้อหรือคำถาม)

Endpoint

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

Header	จำเป็น	คำอธิบาย
`Authorization`	ใช่	คีย์ API ของคุณในรูปแบบ `Bearer YOUR_API_KEY`
`Content-Type`	ใช่	ต้องเป็น `application/json`

เนื้อหาคำขอ

พารามิเตอร์	ชนิด	จำเป็น	คำอธิบาย
`query`	string	ใช่	หัวข้อหรือคำถามสำหรับการสร้างมายด์แมป สูงสุด 2000 ตัวอักษร
`layout`	string	ไม่	ประเภทเลย์เอาต์ ค่าเริ่มต้น: `MIND_MAP`
`livedoc_short_id`	string	ไม่	ID ของ LiveDoc หากไม่ระบุ ระบบจะสร้าง LiveDoc ใหม่โดยอัตโนมัติ

ประเภทเลย์เอาต์

เลย์เอาต์	คำอธิบาย
`MIND_MAP`	มายด์แมปแบบคลาสสิก (ค่าเริ่มต้น)
`LOGICAL_STRUCTURE`	แผนภาพโครงสร้างเชิงตรรกะ
`ORGANIZATION_STRUCTURE`	ผังองค์กร
`CATALOG_ORGANIZATION`	ผังการจัดหมวดหมู่
`TIMELINE`	แผนภาพไทม์ไลน์
`FISHBONE`	แผนภาพก้างปลา

ตัวอย่าง: สร้างด้วย LiveDoc อัตโนมัติ

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

ตัวอย่าง: สร้างด้วย LiveDoc ที่ระบุ

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

การตอบกลับที่สำเร็จ (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"
  }
}

ฟิลด์ของการตอบกลับ

ฟิลด์	ชนิด	คำอธิบาย
`resource_id`	string	ID ทรัพยากรของมายด์แมปที่สร้าง
`status`	string	สถานะของมายด์แมป (เช่น `COMPLETED`)
`livedoc_short_id`	string	ID ย่อของ LiveDoc ที่จัดเก็บมายด์แมป
`mindmap_url`	string	URL สำหรับดูมายด์แมป (รูปแบบ: `{host}/mindmap/{resource_id}`)
`svg`	string	เนื้อหา SVG ของมายด์แมป
`message`	string	ข้อความสถานะ

รหัสข้อผิดพลาด

รหัส	สถานะ HTTP	คำอธิบาย
`UNAUTHORIZED`	401	คีย์ API ไม่ถูกต้องหรือถูกเพิกถอน
`MINDMAP_CREATE_FAILED`	502	การสร้างมายด์แมปล้มเหลว
`LIVEDOC_CREATE_FAILED`	502	การสร้าง LiveDoc ล้มเหลว
`LIVEDOC_NOT_FOUND`	404	ไม่พบ LiveDoc ที่ระบุ
`LLM_SERVICE_UNAVAILABLE`	503	บริการ LLM ไม่พร้อมใช้งาน
`LLM_REQUEST_TIMEOUT`	504	คำขอ LLM หมดเวลา