חיוב ושגיאות ב-OpenAPI

עמוד זה חל על /api/v1/data/*, ה-APIs הבלעדיים של פלטפורמת Felo OpenAPI. הקריאות משתמשות ב-יתרת הפלטפורמה, יתרת קרדיטים של שירות בדולר אמריקאי. הן אינן צורכות Felo Pro credits. ה-Felo APIs הישנים תחת /v2 משתמשים ב-Pro credits.

קראו מחירים נוכחיים

curl -sS https://openapi.felo.ai/api/v1/data/prices

נקודת קצה ציבורית זו אינה דורשת מפתח. התאימו את הרשומות שלה לפי מזהה פעולה וקראו את השיעור הנוכחי ואת יחידת החיוב; אל תניחו שכל פעולה עולה אותו הדבר ואל תקבעו שיעור מתוך דוגמה בתוך האפליקציה שלכם.

שאילתת סטטוס חינמית אינה הופכת את היצירה או הייצוא הבסיסיים לחינמיים. עבור X, דפדוף ורשומות מוחזרות מקוננות עשויים להגדיל את השימוש המחויב.

יתרה והחזקות

לפני ביצוע, השירות יכול לשמור מספיק יתרה עבור הפעולה. עבודה שהושלמה בהצלחה מוסדרת מול ההחזקה הזו; כשל מאושר משחרר אותה. עבור משימות אסינכרוניות, החזרת מזהה אינה אומרת שהחיוב כבר סופי.

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

אם הביצוע או ההסדרה אינם ודאיים, החזקה יכולה להישאר ממתינה בזמן שהשירות מיישב אותה. אל תתייחסו לכל timeout או 5xx כהוכחה לכך שלא נעשתה עבודה או שבקשה חוזרת היא חינמית.

בדקו את היתרה הזמינה ואת השימוש שלכם ב-Console Billing. להנחיות טעינה לחשבון, ראו Billing and Credits.

שאילתת שימוש בארנק דרך ה-API

בעלי חשבון יכולים לבדוק רשומות קריאות בארנק באמצעות Felo login token. אישור זה שונה ממפתח ה-API המשמש לקריאות Data API; אל תחליפו ב-FELO_API_KEY.

curl -sS 'https://openapi.felo.ai/api/wallet/usage?call_type=data' \
  -H 'Authorization: Bearer YOUR_FELO_LOGIN_TOKEN'

הרשומות נמצאות תחת data.items; call_type=data מסנן קריאות יכולת. השוו שימוש למחירים הנוכחיים של החשבון. קריאת הרשומות אינה שולחת משימת יצירה נוספת. Console Billing נשאר זמין לסקירת חשבון ולטעינות.

קראו שגיאות בזהירות

בדקו קודם את סטטוס ה-HTTP. שגיאות יכולות להשתמש באחד מהמבנים הבאים; הערכים למטה הם להמחשה:

{"error":{"code":"invalid_parameter","message":"Check the request fields"},"request_id":"example-request-id"}

{"status":402,"code":"INSUFFICIENT_BALANCE","message":"Insufficient balance","request_id":"example-request-id"}

קראו error.code / error.message כאשר קיימים, אחרת code / message. שמרו request_id כאשר הוא מוחזר. תגובות מוצלחות משתנות לפי פעולה; אל תכריחו את כולן לאותה מעטפת שגיאה או data.

החליטו מה לעשות בהמשך

execution_unconfirmed (409) ו-billing_settlement_pending (503) דורשים זהירות מיוחדת: אל תשלחו שוב מיד עבודה מחויבת. שאבו משימות ידועות או פנו לתמיכה עם request ID. סטטוס HTTP מוצלח עם תוצאה ריקה שונה מתגובת שגיאה.

נסו שוב בלי ליצור עבודה כפולה

• עבור שאילתות read-only של משימה וסטטוס ייצוא, השתמשו ב-backoff מוגבל וכבדו Retry-After כאשר הוא קיים.
• עבור בקשת יצירה שנכשלה עם task_id שמור, שאבו את אותה משימה לפני יצירת אחרת.
• אם החיבור נכשל לפני שקיבלתם מזהה, ייתכן שהתוצאה אינה ידועה. אל תניחו שהשליחה מחדש תבצע deduplication לבקשה.
• עבור 429, הבחינו בין מגבלת קצב קצרה לבין חלון מכסת מפתח API; ניסיונות חוזרים מרובים אינם יכולים לאפס מכסה.
• עצרו ניסיונות חוזרים לאחר דדליין מוגדר והציגו שגיאה ישימה למבצע הקריאה.

לתמיכה, ספקו את נקודת הקצה, זמן משוער, סטטוס HTTP ו-request ID. לעולם אל תכללו את מפתח ה-API המלא.