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 غیر ہم وقت لینڈنگ پیج جنریشن کی صلاحیتیں فراہم کرتا ہے۔ آپ پہلے ٹاسک بناتے ہیں، پھر پیش رفت اور نتائج معلوم کرنے کے لیے موجودہ ٹاسک پولنگ APIs دوبارہ استعمال کرتے ہیں۔

تصدیق

تمام درخواستوں کے لیے Authorization ہیڈر میں API کلید درکار ہے:

Authorization: Bearer YOUR_API_KEY

AI ایجنٹس کے ساتھ استعمال

ایجنٹ کو لینڈنگ پیجز بنانے اور باقی تمام دستیاب Felo Skills استعمال کرنے کی سہولت دینے کے لیے مکمل felo-ai پیکج انسٹال کریں۔ انسٹالر مقررہ فہرست پر انحصار کے بجائے SKILL.md رکھنے والی ہر پیکج ڈائریکٹری کو متحرک طور پر دریافت کرتا ہے۔ دریافت شدہ تمام Skills کو Codex میں ~/.codex/skills، Claude Code میں ~/.claude/skills، OpenClaw میں ~/.agents/skills یا Hermes Agent میں ~/.hermes/skills پر انسٹال کریں۔ پلیٹ فارم کے مخصوص API کلید اور تصدیق کے مراحل کے لیے AI ایجنٹ کی دستی سیٹ اپ گائیڈ پڑھیں۔

لینڈنگ پیج ٹاسک بنائیں

endpoint

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

درخواست ہیڈرز

ہیڈر	لازمی	تفصیل
`Authorization`	ہاں	آپ کی API کلید `Bearer YOUR_API_KEY` کی شکل میں
`Content-Type`	ہاں	`application/json` یا `multipart/form-data`

درخواست باڈی

پیرامیٹر	قسم	لازمی	تفصیل
`query`	string	ہاں	لینڈنگ پیج جنریشن کی درخواست کا پرامپٹ
`stream_protocol`	string	نہیں	اسٹریم پروٹوکول۔ ڈیفالٹ: `message_center_v1`
`livedoc_short_id`	string	نہیں	سیاق و سباق کے طور پر استعمال ہونے والا موجودہ LiveDoc شارٹ ID
`resource_ids`	strings کا ایرے	نہیں	سیاق و سباق کے طور پر استعمال ہونے والے LiveDoc ریسورس IDs

مثال

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

فائل کے ساتھ بنائیں

لینڈنگ پیج ٹاسک کی درخواست کے ساتھ ایک فائل اپ لوڈ کرنے کے لیے multipart/form-data استعمال کریں۔ فائل پہلے LiveDoc ریسورس کے طور پر اپ لوڈ ہوتی ہے، پھر اُس کا ریسورس ID لینڈنگ پیج ٹاسک کو دیا جاتا ہے۔

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	نہیں	اسٹریم پروٹوکول۔ ڈیفالٹ: `message_center_v1`
`livedoc_short_id`	string	نہیں	موجودہ LiveDoc شارٹ ID۔ اگر نہ دیا جائے تو نیا LiveDoc بنتا ہے

کامیاب جواب (200)

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

جواب کے فیلڈز

فیلڈ	قسم	تفصیل
`task_id`	string	بعد کی پولنگ کے لیے async ٹاسک کا شناخت کنندہ

ٹاسک کی حالت پول کریں

لینڈنگ پیج ٹاسکس وہی ٹاسک پولنگ APIs دوبارہ استعمال کرتے ہیں جو PPT ٹاسکس استعمال کرتے ہیں۔

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 کلید غلط یا منسوخ ہے
`LANDING_PAGE_TASK_CREATE_FAILED`	502	لینڈنگ پیج ٹاسک بنانے میں ناکامی
`INSUFFICIENT_CREDITS`	402	کافی کریڈٹ دستیاب نہیں