Felo APIs

Mindmap API

প্রম্পট ও ঐচ্ছিক LiveDoc কনটেক্সট থেকে mindmap তৈরি করুন।

POST/v2/mindmap

অথেন্টিকেশন

Bearer API key

কনটেন্ট টাইপ

application/json

রেট সংক্রান্ত নোট

endpoint-ভিত্তিক সীমা প্রযোজ্য হতে পারে।

LiveDoc API

Mindmap API মাইন্ডম্যাপ তৈরির সক্ষমতা দেয়। একটি টপিক বা প্রশ্ন দিয়ে মাইন্ডম্যাপ তৈরি করতে পারেন এবং ঐচ্ছিকভাবে একটি layout ধরন নির্দিষ্ট করতে পারেন।

প্রমাণীকরণ

সব অনুরোধের Authorization header-এ একটি API Key প্রয়োজন:

Authorization: Bearer YOUR_API_KEY

AI এজেন্টের সাথে ব্যবহার

একটি Agent-কে অন্যান্য সব উপলব্ধ Felo Skill-এর পাশাপাশি মাইন্ডম্যাপ তৈরি করতে দিতে সম্পূর্ণ felo-ai প্যাকেজ ইনস্টল করুন। ইনস্টলার গতিশীলভাবে SKILL.md থাকা প্রতিটি প্যাকেজ ডিরেক্টরি আবিষ্কার করে, তাই ভবিষ্যতের সংযোজনও অন্তর্ভুক্ত হয়। আবিষ্কৃত সব Skill Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills বা Hermes Agent ~/.hermes/skills-এ ইনস্টল করুন। প্রতিটি প্ল্যাটফর্মের নিরাপদ সেটআপ পদ্ধতির জন্য ম্যানুয়াল AI Agent সেটআপ গাইড অনুসরণ করুন।

মাইন্ডম্যাপ তৈরি করুন

একটি query (টপিক বা প্রশ্ন) অনুযায়ী মাইন্ডম্যাপ তৈরি করুন।

Endpoint

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

Header	আবশ্যক	বর্ণনা
`Authorization`	হ্যাঁ	`Bearer YOUR_API_KEY` ফরম্যাটে আপনার API Key
`Content-Type`	হ্যাঁ	অবশ্যই `application/json` হতে হবে

অনুরোধ বডি

প্যারামিটার	ধরন	আবশ্যক	বর্ণনা
`query`	string	হ্যাঁ	মাইন্ডম্যাপ তৈরির টপিক বা প্রশ্ন। সর্বোচ্চ 2000 অক্ষর
`layout`	string	না	Layout ধরন। ডিফল্ট: `MIND_MAP`
`livedoc_short_id`	string	না	LiveDoc ID। না দিলে স্বয়ংক্রিয়ভাবে একটি নতুন LiveDoc তৈরি হবে

Layout ধরন

Layout	বর্ণনা
`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	যে LiveDoc-এ মাইন্ডম্যাপ সংরক্ষিত আছে তার short ID
`mindmap_url`	string	মাইন্ডম্যাপ দেখার URL (ফরম্যাট: `{host}/mindmap/{resource_id}`)
`svg`	string	মাইন্ডম্যাপের SVG কনটেন্ট
`message`	string	স্ট্যাটাস message

ত্রুটি কোড

কোড	HTTP স্ট্যাটাস	বর্ণনা
`UNAUTHORIZED`	401	API Key অবৈধ বা প্রত্যাহৃত
`MINDMAP_CREATE_FAILED`	502	মাইন্ডম্যাপ তৈরি ব্যর্থ
`LIVEDOC_CREATE_FAILED`	502	LiveDoc তৈরি করতে ব্যর্থ
`LIVEDOC_NOT_FOUND`	404	নির্দিষ্ট LiveDoc পাওয়া যায়নি
`LLM_SERVICE_UNAVAILABLE`	503	LLM সার্ভিস অনুপলব্ধ
`LLM_REQUEST_TIMEOUT`	504	LLM অনুরোধের সময় শেষ