הגדרת Felo API
ספק: Felo · משולם מיתרת הפלטפורמה
Felo הוא אחד הספקים ב-Data API, ומציע חיפוש באינטרנט, קריאת אינטרנט, נתוני X, תשובות מבוססות חיפוש ומצגות. מצאו כל נקודת קצה של Felo לצד ספקים אחרים בקטגוריית Data API הרלוונטית.
נקודות קצה אלו משתמשות ב-יתרת הפלטפורמה ובקידומת /api/v1/data. מדריך זה מסביר אימות, את הבקשה הראשונה שלכם והיכן למצוא כללי חיוב.
כדי להשתמש ב-Felo Pro credits, ראו את Felo APIs הקיימים. יתרת הפלטפורמה ו-Felo Pro credits הן נפרדות.
בצעו את הבקשה הראשונה שלכם
- צרו מפתח ב-Console → API Keys.
- בדקו או הטעינו את יתרת הפלטפורמה שלכם ב-Console → Billing.
- הגדירו את המפתח בשרת שלכם או במעטפת המקומית:
export FELO_API_KEY="YOUR_API_KEY"שלחו Authorization: Bearer $FELO_API_KEY. גם X-API-Key מתקבל; בחרו שיטת אימות אחת. בקשות JSON צריכות Content-Type: application/json.
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"What is retrieval augmented generation?","count":3}'HTTP 200 מחזיר מערך resources עם כותרות דפים, קישורים וקטעים, וכן total. הוא אינו מייצר תשובה שיחתית; לצורך זה השתמשו ב-Chat.
עיינו ב-APIs
| מדריך | פעולות | מה תקבלו | יחידת חיוב |
|---|---|---|---|
| חיפוש אינטרנט | חיפוש באינטרנט | כותרות דפים, קישורים וקטעים | בקשה |
| קריאת אינטרנט | קריאת URL | Markdown, טקסט, HTML או צילום מסך | בקשה |
| נתוני X | פרופילים, חיפוש משתמשים, פוסטים של משתמש, חיפוש פוסטים, תגובות | משתמשים ופוסטים מובנים, עם דפדוף היכן שנתמך | תוצאה שהוחזרה |
| צ'אט מבוסס-חיפוש | מענה על שאלה | תשובה ומקורות אינטרנט | בקשה |
| PPT | יצירה, סטטוס, תוצאות, ייצוא, סטטוס ייצוא, מחיקה | משימת יצירה ו-PPTX להורדה | עמוד שנוצר; הייצוא מחויב בנפרד |
| חיוב ושגיאות | הנחיות אינטגרציה משותפות | מחירים, טיפול ביתרה וכללי ניסיון חוזר | — |
ישנם 14 תהליכי ליבה במדריכים אלה. אם יצירת PPT מחזירה stream_key, מדריך PPT מסביר גם כיצד לקרוא אירועי יצירה באמצעות SSE. שאילתות סטטוס ותוצאות, שאילתות סטטוס-ייצוא ומחיקה אינן יוצרות חיוב חדש.
לפני העברת אינטגרציה קיימת
השתמשו במדריך של נקודת הקצה המדויקת שאתם קוראים. החלפת /v2 ב-/api/v1/data אינה העברה מלאה:
- קריאת אינטרנט משתמשת ב-
/web/read, עם פורמט פלט אחד לכל בקשה. - Chat מחזיר
status: "ok"; הוא תומך רק ב-JSON ללא סטרימינג. - תוצאות PPT משתמשות ב-POST
/tasks/{task_id}/historical. - יצירת PPT מחזירה מזהים בשורש ה-JSON. שמרו גם את
task_idוגם אתppt_business_id. - מצגות PPT שנוצרו פגות לאחר שבעה ימים. ייצאו ושמרו את הקובץ לפני התפוגה.
אין כאן מקבילה מקורית מתועדת של OpenAPI לכל תהליך /v2, כגון CRUD של LiveDoc, Mindmap או SuperAgent. המשיכו להשתמש ב-מדריכי Felo APIs ובחיוב Pro-credit.
החוזה והמחירים הנוכחיים
- סכימת OpenAPI שפורסמה — הגדרות שדות וסכימות תגובה.
- סכימת OpenAPI ב-YAML — לכלים שמקבלים YAML.
- מחירים נוכחיים — מזהי פעולות, יחידות חיוב ושיעורים נוכחיים.
משאבים אלו ציבוריים וניתן לקרוא אותם ללא מפתח. ראו חיוב ושגיאות לפני הוספת ניסיונות חוזרים אוטומטיים.