Felo APIs

Mindmap API

प्रॉम्प्ट और वैकल्पिक LiveDoc कॉन्टेक्स्ट से mindmaps बनाएं।

POST/v2/mindmap

प्रमाणीकरण

Bearer API key

कंटेंट टाइप

application/json

दर संबंधी नोट

endpoint-विशिष्ट सीमाएं लागू हो सकती हैं।

LiveDoc API

Mindmap API mindmap जनरेशन क्षमताएं देती है। आप किसी विषय या प्रश्न से mindmap बना सकते हैं, और वैकल्पिक रूप से layout प्रकार निर्दिष्ट कर सकते हैं।

प्रमाणीकरण

सभी अनुरोधों के लिए Authorization हेडर में API Key ज़रूरी है:

Authorization: Bearer YOUR_API_KEY

AI Agent के साथ उपयोग करें

Agent को हर अन्य उपलब्ध Felo Skill के साथ mindmap बनाने देने के लिए पूरा felo-ai पैकेज इंस्टॉल करें। इंस्टॉलर SKILL.md वाली हर पैकेज डायरेक्टरी को गतिशील रूप से खोजता है, इसलिए भविष्य में जुड़ने वाली चीज़ें भी शामिल होती हैं। सभी खोजी गई Skills को Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills या Hermes Agent ~/.hermes/skills में इंस्टॉल करें। हर प्लेटफ़ॉर्म के सुरक्षित सेटअप तरीके के लिए मैन्युअल AI Agent सेटअप गाइड का पालन करें।

Mindmap बनाएं

किसी क्वेरी (विषय या प्रश्न) के आधार पर mindmap बनाएं।

Endpoint

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

अनुरोध हेडर

हेडर	आवश्यक	विवरण
`Authorization`	हां	`Bearer YOUR_API_KEY` फ़ॉर्मेट में आपकी API Key
`Content-Type`	हां	`application/json` होना चाहिए

अनुरोध बॉडी

पैरामीटर	प्रकार	आवश्यक	विवरण
`query`	string	हां	mindmap जनरेशन के लिए विषय या प्रश्न। अधिकतम 2000 अक्षर
`layout`	string	नहीं	Layout प्रकार। डिफ़ॉल्ट: `MIND_MAP`
`livedoc_short_id`	string	नहीं	LiveDoc ID। अगर नहीं दिया जाए, तो स्वचालित रूप से नया LiveDoc बनेगा

Layout प्रकार

Layout	विवरण
`MIND_MAP`	क्लासिक 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	बनाए गए mindmap का resource ID
`status`	string	mindmap की स्थिति (जैसे `COMPLETED`)
`livedoc_short_id`	string	वह LiveDoc short ID जहां mindmap संग्रहित है
`mindmap_url`	string	mindmap देखने का URL (फ़ॉर्मेट: `{host}/mindmap/{resource_id}`)
`svg`	string	mindmap की SVG सामग्री
`message`	string	स्थिति संदेश

त्रुटि कोड

कोड	HTTP स्टेटस	विवरण
`UNAUTHORIZED`	401	API Key अमान्य या रद्द है
`MINDMAP_CREATE_FAILED`	502	mindmap निर्माण विफल
`LIVEDOC_CREATE_FAILED`	502	LiveDoc बनाने में विफल
`LIVEDOC_NOT_FOUND`	404	निर्दिष्ट LiveDoc नहीं मिला
`LLM_SERVICE_UNAVAILABLE`	503	LLM सेवा अनुपलब्ध है
`LLM_REQUEST_TIMEOUT`	504	LLM अनुरोध का समय समाप्त