Felo APIs
Landing Page Task API
צרו דפי נחיתה באופן אסינכרוני ושאלו על היסטוריית המשימות.
/v2/landing_pageאימות
Bearer API key
סוג תוכן
application/json or multipart/form-data
הערות תעריף
ייתכנו מגבלות ספציפיות ל-endpoint.
עמוד זה מתעד את ה-Felo APIs הקיימים ב-/v2, תוך שימוש ב-זכויות חשבון Felo וכללי Pro-credit. האם זיכויים מנוכים תלוי ב-פעולה. עבור קריאות עם יתרת הפלטפורמה, בחרו נקודת קצה נתמכת של Felo OpenAPI; צורות הבקשה והתגובה יכולות להשתנות.
The Landing Page Task API מספק יכולות יצירת דפי נחיתה אסינכרוניות. אתם יוצרים משימה תחילה, ואז משתמשים שוב ב-APIs הקיימים של polling משימות כדי לשאול על ההתקדמות והתוצאות.
Use with AI Agents
התקינו את החבילה המלאה felo-ai כדי לאפשר לסוכן ליצור דפי נחיתה ולהשתמש בכל Skill זמין אחר של Felo. המתקין מגלה באופן דינמי כל ספריית חבילה שמכילה SKILL.md, במקום להסתמך על רשימה קבועה. התקינו את כל ה-Skills שהתגלו ב-Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills, או Hermes Agent ~/.hermes/skills. קראו את מדריך ההתקנה הידנית של AI Agent עבור מפתח ה-API ושלבי האימות הספציפיים לפלטפורמה.
Authentication
כל הבקשות דורשות מפתח API בכותרת Authorization:
Authorization: Bearer YOUR_API_KEYCreate Landing Page Task
Endpoint
POST https://openapi.felo.ai/v2/landing_pageRequest Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | מפתח ה-API שלכם בפורמט Bearer YOUR_API_KEY |
Content-Type | Yes | application/json או multipart/form-data |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | פרומפט לבקשת יצירת דף נחיתה |
stream_protocol | string | No | פרוטוקול סטרים. ברירת מחדל: message_center_v1 |
livedoc_short_id | string | No | מזהה LiveDoc קצר קיים לשימוש כהקשר |
resource_ids | array of strings | No | מזהי משאבי LiveDoc לשימוש כהקשר |
Example
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"
}'Create With File
השתמשו ב-multipart/form-data כדי להעלות קובץ אחד עם בקשת משימת Landing Page. הקובץ מועלֶה תחילה כמשאב LiveDoc, ואז מזהה המשאב שלו מועבר למשימת ה-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]'Optional multipart parts:
| Parameter | Type | Required | Description |
|---|---|---|---|
stream_protocol | string | No | פרוטוקול סטרים. ברירת מחדל: message_center_v1 |
livedoc_short_id | string | No | מזהה LiveDoc קצר קיים. אם מושמט, נוצר LiveDoc חדש |
Success Response (200)
{
"status": 200,
"code": "OK",
"request_id": "req_example",
"message": null,
"data": {
"task_id": "019cad6d-e874-55ef-d577-686344b5a7e9"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
task_id | string | מזהה משימה אסינכרונית להמשך polling |
Poll Task Status
משימות Landing Page משתמשות באותן APIs של polling משימות כמו משימות PPT.
Endpoint
GET https://openapi.felo.ai/v2/tasks/{task_id}/statusExample
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 Task Historical Info
Endpoint
GET https://openapi.felo.ai/v2/tasks/{task_id}/historicalExample
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 Response Example
{
"status": 200,
"code": "OK",
"request_id": "req_example",
"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://api-ext-index-file.felo.ai/html/address?message_id=9qiLTmT77fA3aVurrMHvRJ"
}
}עיינו ב-PPT Task API עבור דוגמאות תגובת polling המשותפות וסמנטיקת הסטטוס.
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
INVALID_API_KEY | 401 | מפתח ה-API אינו תקף או שבוטל |
LANDING_PAGE_TASK_CREATE_FAILED | 502 | יצירת משימת דף נחיתה נכשלה |
INSUFFICIENT_CREDITS | 402 | אין מספיק זיכויים זמינים |
צריך עזרה?
- לשאלות על API, חיוב וחשבון, פנו לתמיכה.
- שוחחו עם מפתחי Felo ב-Discord.
- עיינו ביומן השינויים שלנו.
- צריכים תמחור לפי נפח או עזרה ברכש? צרו קשר עם המכירות.
- בונים עם LLM? קראו את llms.txt.