Felo APIs
Landing Page Task API
สร้าง landing page แบบอะซิงโครนัสและสอบถามประวัติงาน
/v2/landing_pageการยืนยันตัวตน
Bearer API key
ประเภทเนื้อหา
application/json or multipart/form-data
หมายเหตุเรื่องข้อจำกัด
อาจมีข้อจำกัดเฉพาะของ endpoint
Landing Page Task API มอบความสามารถในการสร้างหน้าแลนดิ้งแบบอะซิงโครนัส คุณสร้างงานก่อน แล้วใช้ API สำหรับโพลสถานะงานที่มีอยู่เดิมเพื่อสอบถามความคืบหน้าและผลลัพธ์
การรับรองความถูกต้อง
ทุกคำขอต้องมีคีย์ API ใน header Authorization:
Authorization: Bearer YOUR_API_KEYใช้กับ AI Agent
ติดตั้งแพ็กเกจ felo-ai ที่ครบถ้วนเพื่อให้ Agent สร้างหน้าแลนดิ้งและใช้ Felo Skill อื่น ๆ ที่มีให้ใช้ทั้งหมด ตัวติดตั้งจะค้นหาไดเรกทอรีแพ็กเกจทุกไดเรกทอรีที่มี SKILL.md แบบไดนามิก แทนการพึ่งพารายการแบบตายตัว ให้ติดตั้ง Skill ทั้งหมดที่ค้นพบใน Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills หรือ Hermes Agent ~/.hermes/skills อ่านคู่มือการตั้งค่า AI Agent ด้วยตนเองสำหรับคีย์ API และขั้นตอนการตรวจสอบเฉพาะแพลตฟอร์ม
สร้างงาน Landing Page
Endpoint
POST https://openapi.felo.ai/v2/landing_pageHeader ของคำขอ
| Header | จำเป็น | คำอธิบาย |
|---|---|---|
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 | ไม่ | ID ย่อของ LiveDoc ที่มีอยู่เพื่อใช้เป็นบริบท |
resource_ids | array of strings | ไม่ | ID ทรัพยากรของ LiveDoc เพื่อใช้เป็นบริบท |
ตัวอย่าง
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 เพื่ออัปโหลดไฟล์หนึ่งไฟล์พร้อมคำขอของงาน Landing Page ไฟล์จะถูกอัปโหลดเป็นทรัพยากร LiveDoc ก่อน จากนั้น 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 | ไม่ | โปรโตคอลสตรีม ค่าเริ่มต้น: message_center_v1 |
livedoc_short_id | string | ไม่ | ID ย่อของ LiveDoc ที่มีอยู่ หากละเว้น ระบบจะสร้าง LiveDoc ใหม่ |
การตอบกลับที่สำเร็จ (200)
{
"status": "ok",
"message": null,
"data": {
"task_id": "019cad6d-e874-55ef-d577-686344b5a7e9"
}
}ฟิลด์ของการตอบกลับ
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
task_id | string | ตัวระบุงานอะซิงโครนัสสำหรับการโพลในภายหลัง |
โพลสถานะงาน
งาน Landing Page ใช้ API สำหรับโพลสถานะงานเดียวกับงาน 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 | การสร้างงาน Landing Page ล้มเหลว |
INSUFFICIENT_CREDITS | 402 | เครดิตคงเหลือไม่เพียงพอ |