Felo APIs
Landing Page Task API
ল্যান্ডিং পেজ অ্যাসিঙ্ক্রোনাসভাবে তৈরি করুন এবং টাস্ক ইতিহাস দেখুন।
/v2/landing_pageঅথেন্টিকেশন
Bearer API key
কনটেন্ট টাইপ
application/json or multipart/form-data
রেট সংক্রান্ত নোট
endpoint-ভিত্তিক সীমা প্রযোজ্য হতে পারে।
Landing Page Task API অ্যাসিঙ্ক্রোনাস landing page তৈরির সক্ষমতা দেয়। আপনি প্রথমে একটি টাস্ক তৈরি করেন, তারপর অগ্রগতি ও ফলাফল জানতে বিদ্যমান টাস্ক পোলিং API পুনরায় ব্যবহার করেন।
প্রমাণীকরণ
সব অনুরোধের Authorization header-এ একটি API Key প্রয়োজন:
Authorization: Bearer YOUR_API_KEYAI এজেন্টের সাথে ব্যবহার
একটি Agent-কে landing page তৈরি করতে এবং অন্যান্য সব উপলব্ধ Felo Skill ব্যবহার করতে দিতে সম্পূর্ণ felo-ai প্যাকেজ ইনস্টল করুন। ইনস্টলার নির্দিষ্ট তালিকার উপর নির্ভর না করে গতিশীলভাবে SKILL.md থাকা প্রতিটি প্যাকেজ ডিরেক্টরি আবিষ্কার করে। আবিষ্কৃত সব Skill 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অনুরোধ Header
| Header | আবশ্যক | বর্ণনা |
|---|---|---|
Authorization | হ্যাঁ | Bearer YOUR_API_KEY ফরম্যাটে আপনার API Key |
Content-Type | হ্যাঁ | application/json বা multipart/form-data |
অনুরোধ বডি
| প্যারামিটার | ধরন | আবশ্যক | বর্ণনা |
|---|---|---|---|
query | string | হ্যাঁ | Landing page তৈরির অনুরোধ prompt |
stream_protocol | string | না | Stream protocol। ডিফল্ট: message_center_v1 |
livedoc_short_id | string | না | context হিসেবে ব্যবহারের জন্য বিদ্যমান LiveDoc short ID |
resource_ids | array of strings | না | context হিসেবে ব্যবহারের জন্য LiveDoc রিসোর্স 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 part:
| প্যারামিটার | ধরন | আবশ্যক | বর্ণনা |
|---|---|---|---|
stream_protocol | string | না | Stream protocol। ডিফল্ট: 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 | পরবর্তী পোলিংয়ের জন্য অ্যাসিঙ্ক টাস্ক শনাক্তকারী |
টাস্ক স্ট্যাটাস পোল করুন
Landing Page টাস্ক PPT টাস্কের মতো একই টাস্ক পোলিং 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'টাস্কের ঐতিহাসিক তথ্য query করুন
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 Completed রেসপন্স উদাহরণ
{
"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 | পর্যাপ্ত ক্রেডিট নেই |