איך פועל ה-Batch API?
ה-endpoint של ה-Batch API, המתועד כאן, מאפשר למשתמשים לשלוח בקשות לעיבוד אצווה אסינכרוני. נעבד את הבקשות האלה תוך 24 שעות. הפרטים של כל בקשה ייקראו מקובץ שהועלה מראש, והתשובות ייכתבו לקובץ פלט. אפשר לשלוח שאילתה לאובייקט האצווה כדי לקבל עדכוני סטטוס ותוצאות.
מה התמחור של ה-Batch API?
כל מודל יוצע בהנחה של 50% לעומת ממשקי ה-API הסינכרוניים. כאן תמצאו מידע נוסף על תמחור ה-API שלנו.
באילו מודלים אפשר להשתמש לעיבוד אצווה?
ה-Batch API זמין ברוב המודלים שלנו, אך לא בכולם. עיינו בתיעוד המודלים כדי לוודא שהמודל שבו אתם משתמשים תומך ב-Batch API.
מה קורה אם ה-API לא משלים את הבקשה שלי בזמן שהובטח?
אנו שואפים להשלים את כל הבקשות תוך 24 שעות. אם תוקף האצווה פג (כלומר, לא ניתן היה להשלים אותה במסגרת הזמן שנקבעה בהסכם רמת השירות), יתרת העבודה מבוטלת והתוצאות של כל עבודה שכבר הושלמה מוחזרות. המפתחים יחויבו על כל עבודה שהושלמה.
מהי מגבלת מספר הבקשות שאפשר לשלוח לעיבוד אצווה?
בממשקי ה-API להטמעות (Embeddings) יש מגבלה של מיליון בקשות בתור בכל רגע נתון.
בכל שאר ממשקי ה-API אין מגבלה על מספר הבקשות שאפשר לשלוח לעיבוד אצווה; עם זאת, לכל רמת שימוש מוגדרת מגבלת קצב לעיבוד אצווה. מגבלת הקצב שלכם לעיבוד אצווה כוללת את המספר המרבי של טוקני קלט שיכולים להימצא בתור בכל רגע נתון. אפשר למצוא את מגבלות הקצב שלכם כאן.
האם אפשר לשנות את זמן ההמתנה לקבלת תשובה מה-Batch API?
מסגרת הזמן המוגדרת שלנו כיום היא 24 שעות. כרגע אין באפשרותנו לשנות את פרק הזמן הזה.
האם ה-Batch API תומך בהזרמה?
לא, ה-Batch API אינו תומך בהזרמה. בקשות אצווה מחזירות תוצאות באמצעות קובצי פלט ולא באמצעות תשובות בהזרמה.
האם ה-Batch API תומך בתמונות?
כן, ה-Batch API תומך בתמונות.
קיבלתי הודעת שגיאה: ״הקידומת של כתובת ה-URL שסופקה לבקשה זו אינה תואמת ל-endpoint של האצווה״. מה עליי לעשות?
השגיאה הזו מציינת שמבנה כתובת ה-URL שלכם אינו תקין עבור ה-endpoint של ה-Batch API. עיינו בתיעוד שלנו כאן כדי לוודא שאתם קוראים ל-endpoint בצורה הנכונה.
האם השימוש ב-Batch API נכלל בחישוב מגבלות הקצב האחרות שלי?
מגבלות הקצב של ה-Batch API נפרדות לחלוטין מהמגבלות הקיימות.
מה קורה אם אצווה מבוטלת?
אם אצווה מבוטלת ידנית, מוחזרות כל התוצאות שכבר הושלמו. המפתחים יחויבו על כל עבודה שהושלמה.
מה קורה אם תוקף האצווה פג?
אם תוקף האצווה פג (כלומר, לא ניתן היה להשלים אותה במסגרת הזמן שנקבעה בהסכם רמת השירות), יתרת העבודה מבוטלת והתוצאות של כל עבודה שכבר הושלמה מוחזרות. המפתחים יחויבו על כל עבודה שהושלמה.
אילו סטטוסים אפשריים למשימות אצווה?
משימת אצווה יכולה להיות בכל אחד מהסטטוסים הבאים: באימות, נכשלה, בעיבוד, בשלבי סיום, הושלמה, פג תוקפה, בתהליך ביטול ובוטלה. לבדיקת ערכי הסטטוס של ה-API באמצעות קוד, השתמשו בערכים המדויקים באותיות קטנות: validating, failed, in_progress, finalizing, completed, expired, cancelling, cancelled.
באימות: הקובץ שהועלה עובר אימות לפני שניתן להתחיל בעיבוד האצווה.
נכשלה: הקובץ לא עבר את תהליך האימות.
בעיבוד: הקובץ אומת בהצלחה, ועיבוד האצווה מתבצע כעת.
בשלבי סיום: משימת האצווה הושלמה, והתוצאות נמצאות בהכנה.
הושלמה: משימת האצווה הושלמה והתוצאות מוכנות.
פג תוקפה: לא ניתן היה להשלים את האצווה במסגרת הזמן שנקבעה בהסכם רמת השירות (SLA).
בתהליך ביטול: החל תהליך הביטול של משימת האצווה.
בוטלה: משימת האצווה בוטלה.
איך אפשר לבדוק אילו משימות אצווה כבר יצרתי?
אפשר לקבל רשימה של כל משימות האצווה שלכם באמצעות קריאת ה-API המפורטת כאן.
האם ה-endpoint הזה תומך באפס שמירת נתונים (ZDR)?
אם אפס שמירת נתונים (ZDR) מופעל בארגון שלכם, שימו לב שאפס שמירת נתונים (ZDR) אינו חל על ה-Batch API. ארגוני ZDR יכולים ליצור משימות אצווה, אך קובצי הקלט של האצווה, הפלטים, השגיאות ותוצרי הביניים נשמרים בהתאם למדיניות שמירת הנתונים המוגדרת של Batch, File Service ו-Sediment.