Πώς λειτουργεί το Batch API;
Το τελικό σημείο Batch API, όπως τεκμηριώνεται εδώ, επιτρέπει στους χρήστες να υποβάλλουν αιτήματα για ασύγχρονη μαζική επεξεργασία. Θα επεξεργαστούμε αυτά τα αιτήματα εντός 24 ωρών. Οι λεπτομέρειες κάθε αιτήματος θα διαβαστούν από ένα προφορτωμένο αρχείο και οι απαντήσεις θα εγγραφούν σε ένα αρχείο εξόδου. Μπορείτε να υποβάλετε ερώτημα στο αντικείμενο δέσμης για ενημερώσεις κατάστασης και αποτελέσματα.
Ποια είναι η τιμολόγηση για το Batch API;
Κάθε μοντέλο θα προσφέρεται με έκπτωση κόστους 50% σε σχέση με τα σύγχρονα API. Ακολουθούν περισσότερες πληροφορίες σχετικά με την τιμολόγηση των API μας.
Ποια μοντέλα μπορώ να χρησιμοποιήσω σε δέσμη;
Το Batch API είναι ευρέως διαθέσιμο στα περισσότερα μοντέλα μας, αλλά όχι σε όλα. Ανατρέξτε στα έγγραφα αναφοράς μοντέλων για να βεβαιωθείτε ότι το μοντέλο που χρησιμοποιείτε υποστηρίζει το Batch API.
Τι συμβαίνει αν το API δεν ολοκληρώσει το αίτημά μου εντός του υποσχόμενου χρόνου;
Στόχος μας είναι να ολοκληρώνουμε όλα τα αιτήματα εντός 24 ωρών. Αν μια δέσμη λήξει (δηλαδή δεν μπόρεσε να ολοκληρωθεί εντός του χρονικού παραθύρου SLA), τότε η υπόλοιπη εργασία ακυρώνεται και επιστρέφεται οποιαδήποτε εργασία έχει ήδη ολοκληρωθεί. Οι προγραμματιστές θα χρεωθούν για κάθε εργασία που έχει ολοκληρωθεί.
Ποιο είναι το όριο για το πόσα αιτήματα μπορώ να βάλω σε δέσμη;
Τα API Embeddings έχουν όριο 1 εκατομμύριο αιτήματα σε ουρά κάθε φορά.
Για όλα τα άλλα API, δεν υπάρχει όριο στον αριθμό των αιτημάτων που μπορείτε να βάλετε σε δέσμη. Ωστόσο, κάθε βαθμίδα χρήσης έχει ένα σχετικό όριο ρυθμού δέσμης. Το όριο ρυθμού δέσμης περιλαμβάνει τον μέγιστο αριθμό token εισόδου που έχετε σε ουρά κάθε φορά. Μπορείτε να βρείτε τα όρια ρυθμού σας εδώ.
Μπορώ να αλλάξω τον χρόνο που απαιτείται για να λάβω απάντηση από το Batch API;
Το τρέχον καθορισμένο χρονικό παράθυρό μας είναι 24 ώρες. Προς το παρόν δεν μπορούμε να αλλάξουμε αυτήν τη χρονική περίοδο.
Υποστηρίζεται η ροή στο Batch API;
Όχι, η ροή δεν υποστηρίζεται στο Batch API. Τα αιτήματα δέσμης επιστρέφουν αποτελέσματα μέσω αρχείων εξόδου και όχι μέσω απαντήσεων ροής.
Υποστηρίζονται εικόνες στο Batch API;
Ναι, οι εικόνες υποστηρίζονται στο Batch API.
Έλαβα ένα μήνυμα σφάλματος «The URL provided for this request does not prefix-match the batch endpoint». Τι πρέπει να κάνω;
Αν λάβετε αυτό το σφάλμα, αυτό σημαίνει ότι το URL σας έχει εσφαλμένη μορφοποίηση για το τελικό σημείο Batch API. Ανατρέξτε στην τεκμηρίωσή μας εδώ για να βεβαιωθείτε ότι καλείτε σωστά το τελικό σημείο.
Η χρήση του Batch API συνυπολογίζεται στα άλλα όρια ρυθμού μου;
Τα όρια ρυθμού του Batch API είναι εντελώς ξεχωριστά από τα υπάρχοντα όρια.
Τι συμβαίνει αν ακυρωθεί μια δέσμη;
Αν μια δέσμη ακυρωθεί μη αυτόματα, επιστρέφονται όσα αποτελέσματα έχουν ήδη ολοκληρωθεί. Οι προγραμματιστές θα χρεωθούν για κάθε εργασία που έχει ολοκληρωθεί.
Τι συμβαίνει αν μια δέσμη λήξει;
Αν μια δέσμη λήξει (δηλαδή δεν μπόρεσε να ολοκληρωθεί εντός του χρονικού παραθύρου SLA), τότε η υπόλοιπη εργασία ακυρώνεται και επιστρέφεται οποιαδήποτε εργασία έχει ήδη ολοκληρωθεί. Οι προγραμματιστές θα χρεωθούν για κάθε εργασία που έχει ολοκληρωθεί.
Ποιες καταστάσεις μπορώ να αναμένω στις εργασίες δέσμης;
Η εργασία δέσμης μπορεί να έχει οποιαδήποτε από τις εξής καταστάσεις: Επικύρωση, Αποτυχία, Σε εξέλιξη, Οριστικοποίηση, Ολοκληρώθηκε, Έληξε, Ακύρωση και Ακυρώθηκε. Αν ελέγχετε τιμές κατάστασης API μέσω προγραμματισμού, χρησιμοποιήστε τα πεζά λεκτικά: validating, failed, in_progress, finalizing, completed, expired, cancelling και cancelled.
Επικύρωση: Η επικύρωση του μεταφορτωμένου αρχείου βρίσκεται σε εξέλιξη πριν ξεκινήσει η δέσμη.
Αποτυχία: Το αρχείο απέτυχε στη διαδικασία επικύρωσης.
Σε εξέλιξη: Το αρχείο επικυρώθηκε με επιτυχία και η διαδικασία δέσμης βρίσκεται σε εξέλιξη.
Οριστικοποίηση: Η εργασία δέσμης έχει ολοκληρωθεί και τα αποτελέσματα προετοιμάζονται.
Ολοκληρώθηκε: Η εργασία δέσμης έχει ολοκληρωθεί και τα αποτελέσματα είναι έτοιμα.
Έληξε: Η δέσμη δεν μπόρεσε να ολοκληρωθεί εντός του χρονικού παραθύρου SLA.
Ακύρωση: Η ακύρωση της εργασίας δέσμης έχει ξεκινήσει.
Ακυρώθηκε: Η εργασία δέσμης ακυρώθηκε.
Πώς μπορώ να ελέγξω ποιες εργασίες δέσμης έχω ήδη δημιουργήσει;
Μπορείτε να λάβετε μια λίστα με όλες τις εργασίες δέσμης σας χρησιμοποιώντας την κλήση API που καθορίζεται εδώ.
Υποστηρίζεται η μη διατήρηση δεδομένων σε αυτό το τελικό σημείο;
Αν έχετε ενεργοποιήσει τη μη διατήρηση δεδομένων για τον οργανισμό σας, λάβετε υπόψη ότι η μη διατήρηση δεδομένων δεν ισχύει για το Batch API. Οι οργανισμοί ZDR μπορούν να δημιουργούν εργασίες δέσμης, αλλά τα αρχεία εισόδου δέσμης, οι έξοδοι, τα σφάλματα και τα ενδιάμεσα τεχνουργήματα διατηρούνται σύμφωνα με τις διαμορφωμένες πολιτικές διατήρησης Batch, File Service και Sediment.