Felo APIs

Landing Page Task API

लैंडिंग पेज असिंक्रोनस रूप से जनरेट करें और टास्क इतिहास देखें।

POST/v2/landing_page

प्रमाणीकरण

Bearer API key

कंटेंट टाइप

application/json or multipart/form-data

दर संबंधी नोट

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

PPT Task API LiveDoc API

Landing Page Task API असिंक्रोनस landing page जनरेशन क्षमताएं देती है। आप पहले कार्य बनाते हैं, फिर प्रगति और परिणाम देखने के लिए मौजूदा task polling API का पुनः उपयोग करते हैं।

प्रमाणीकरण

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

Authorization: Bearer YOUR_API_KEY

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

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

Landing Page कार्य बनाएं

Endpoint

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

अनुरोध हेडर

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

अनुरोध बॉडी

पैरामीटर	प्रकार	आवश्यक	विवरण
`query`	string	हां	Landing page जनरेशन के लिए प्रॉम्प्ट
`stream_protocol`	string	नहीं	Stream प्रोटोकॉल। डिफ़ॉल्ट: `message_center_v1`
`livedoc_short_id`	string	नहीं	कॉन्टेक्स्ट के रूप में उपयोग करने के लिए मौजूदा LiveDoc short ID
`resource_ids`	array of strings	नहीं	कॉन्टेक्स्ट के रूप में उपयोग करने के लिए LiveDoc resource ID

उदाहरण

curl -X POST 'https://openapi.felo.ai/v2/landing_page' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Generate a landing page for Felo Search"
  }'

फ़ाइल के साथ बनाएं

Landing Page कार्य अनुरोध के साथ एक फ़ाइल अपलोड करने के लिए multipart/form-data उपयोग करें। फ़ाइल पहले LiveDoc संसाधन के रूप में अपलोड होती है, फिर उसका resource ID Landing Page कार्य को पास किया जाता है।

curl -X POST 'https://openapi.felo.ai/v2/landing_page' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'query=Generate a landing page from this product brief' \
  -F '[email protected]'

वैकल्पिक multipart भाग:

पैरामीटर	प्रकार	आवश्यक	विवरण
`stream_protocol`	string	नहीं	Stream प्रोटोकॉल। डिफ़ॉल्ट: `message_center_v1`
`livedoc_short_id`	string	नहीं	मौजूदा LiveDoc short ID। छोड़ने पर नया LiveDoc बनता है

सफल प्रतिक्रिया (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9"
  }
}

प्रतिक्रिया फ़ील्ड

फ़ील्ड	प्रकार	विवरण
`task_id`	string	आगे पोलिंग के लिए async कार्य पहचानकर्ता

कार्य की स्थिति पोल करें

Landing Page कार्य PPT कार्यों जैसे ही task polling API का पुनः उपयोग करते हैं।

Endpoint

GET https://openapi.felo.ai/v2/tasks/{task_id}/status

उदाहरण

curl -X GET 'https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

कार्य की ऐतिहासिक जानकारी देखें

Endpoint

GET https://openapi.felo.ai/v2/tasks/{task_id}/historical

उदाहरण

curl -X GET 'https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/historical' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

AI_PAGE पूर्ण होने की प्रतिक्रिया का उदाहरण

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019d7a4d-6ab5-a96d-0f98-43ca434ab621",
    "task_status": "COMPLETED",
    "ppt_biz_id": "9qiLTmT77fA3aVurrMHvRJ",
    "ppt_url": "https://felo.ai/slides/9qiLTmT77fA3aVurrMHvRJ",
    "ai_page_html": "https://felo.ai/ai-page/9qiLTmT77fA3aVurrMHvRJ"
  }
}

साझा पोलिंग प्रतिक्रिया उदाहरणों और स्थिति अर्थों के लिए PPT Task API देखें।

त्रुटि कोड

कोड	HTTP स्टेटस	विवरण
`UNAUTHORIZED`	401	API Key अमान्य या रद्द है
`LANDING_PAGE_TASK_CREATE_FAILED`	502	Landing page कार्य निर्माण विफल
`INSUFFICIENT_CREDITS`	402	अपर्याप्त क्रेडिट उपलब्ध