Felo API PlatformFelo API Platform

Felo APIs

Landing Page Task API

צרו דפי נחיתה באופן אסינכרוני ושאלו על היסטוריית המשימות.

POST/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_KEY

Create Landing Page Task

Endpoint

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

Request Headers

HeaderRequiredDescription
AuthorizationYesמפתח ה-API שלכם בפורמט Bearer YOUR_API_KEY
Content-TypeYesapplication/json או multipart/form-data

Request Body

ParameterTypeRequiredDescription
querystringYesפרומפט לבקשת יצירת דף נחיתה
stream_protocolstringNoפרוטוקול סטרים. ברירת מחדל: message_center_v1
livedoc_short_idstringNoמזהה LiveDoc קצר קיים לשימוש כהקשר
resource_idsarray of stringsNoמזהי משאבי 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:

ParameterTypeRequiredDescription
stream_protocolstringNoפרוטוקול סטרים. ברירת מחדל: message_center_v1
livedoc_short_idstringNoמזהה 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

FieldTypeDescription
task_idstringמזהה משימה אסינכרונית להמשך polling

Poll Task Status

משימות Landing Page משתמשות באותן APIs של polling משימות כמו משימות PPT.

Endpoint

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

Example

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}/historical

Example

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

CodeHTTP StatusDescription
INVALID_API_KEY401מפתח ה-API אינו תקף או שבוטל
LANDING_PAGE_TASK_CREATE_FAILED502יצירת משימת דף נחיתה נכשלה
INSUFFICIENT_CREDITS402אין מספיק זיכויים זמינים

צריך עזרה?