יצירת מצגת Felo

צרו מצגת באופן אסינכרוני, ואז ייצאו קובץ PPTX. הפרידו בין שלב היצירה לשלב הייצוא: משימה שנוצרה עדיין אינה קובץ גמור.

כל הדוגמאות משתמשות ב-FELO_API_KEY מתוך הסקירה הכללית. הקריאות משתמשות ב-יתרת הפלטפורמה, ולא ב-Felo Pro credits. דוגמאות התגובה הן להמחשה; תוכן חי ושדות אופציונליים משתנים.

1. יצירת המצגת

POST /api/v1/data/ppts

לאינטגרציה ראשונה, השמיטו את שדות ההקשר והתצורה. הקשר שנוצר דרך /v2 אינו זכאי אוטומטית לשימוש חוזר כאן.

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/ppts" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Create a 5-slide introduction to retrieval augmented generation for software developers."}'

HTTP 200 מחזיר מזהים בשורש:

{
  "task_id":"example-task-id",
  "ppt_business_id":"example-ppt-id",
  "livedoc_short_id":"example-livedoc-id",
  "expires_at":"2026-11-13T00:00:00Z"
}

מזהים נוספים כגון resource_id, stream_key ו-thread_short_id עשויים להופיע. תגובת יצירה מוצלחת פירושה שהמשימה התקבלה, לא שהיצירה הושלמה. מספר השקפים המבוקש הוא הנחיה; החיוב משתמש במספר העמודים שנוצר בפועל.

TASK_ID="example-task-id"
PPT_ID="example-ppt-id"

קריאת אירועי יצירה באמצעות SSE

אם היצירה מחזירה stream_key, התחברו מיד עם API Key השייך לאותו חשבון. אם לא מוחזר stream key, השתמשו בשאילתות הסטטוס והתוצאות למטה.

curl -N 'https://openapi.felo.ai/api/v1/data/conversations/stream/YOUR_STREAM_KEY?format=structured' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: text/event-stream'

קראו כל אירוע SSE מלא, פענחו את ה-JSON החיצוני שלו, ואז עבדו על content. אירוע יישום מסוג answer נושא טקסט ב-data.text; finished מסמן השלמת יצירה בזרם. טפלו גם באותות upstream done, [DONE], ו-error. אם החיבור נסגר ללא אות השלמה, שאבו את סטטוס המשימה.

השתמשו בכללי הפענוח ובדוגמת הלקוח ב-SuperAgent SSE, עם כתובת ה-URL של סעיף זה /api/v1/data/conversations/stream/{stream_key}. קראו את תוצאת המשימה לאחר שהזרם מסתיים; ייצוא PPTX נשאר שלב נפרד. נקודת קצה זו אינה מפעילה stream: true ב-/api/v1/data/chat.

משך חיים, בעלות וחיוב

• מצגות פגות שבעה ימים לאחר היצירה. שאילתות וייצואים אינם מאריכים תקופה זו. expires_at של המצגת ו-expires_at של URL ההורדה החתום מתארים משכי חיים שונים.
• רק חשבון ה-API שיצר יכול לגשת למשימות ולמצגות שלו. משאב חסר או לא נגיש יכול להחזיר 404; משאב שפג תוקפו או נמחק יכול להחזיר 410, או 404 לאחר ניקוי.
• היצירה מחויבת לפי עמוד שנוצר (ppt.generate). לפי תמחור עמודים, היצירה שומרת את המחיר של עשרה עמודים, ואז מסדירה את הפלט המוצלח בפועל ומשחררת את ההחזקה שלא נוצלה. לחשבון שלכם חייבת להיות יתרה זמינה מספקת עבור ההחזקה גם אם הפרומפט מבקש פחות עמודים.
• לייצוא יש מחיר בקשה נפרד (ppt.export). שאילתות סטטוס, שאילתות תוצאות, שאילתות סטטוס-ייצוא ומחיקה אינן יוצרות חיוב חדש.
• לאחר timeout, שאבו את המשימה השמורה במקום ליצור מצגת נוספת. ראו חיוב ושגיאות.