Επισκόπηση
Η χρήση του API υπόκειται σε όρια ρυθμού. Αυτά τα όρια περιορίζουν τα αιτήματα, τα token ή άλλες μορφές χρήσης εντός συγκεκριμένου χρονικού διαστήματος.
Μια απόκριση 429 μπορεί να υποδεικνύει προσωρινό όριο ρυθμού, εξάντληση του προπληρωμένου υπολοίπου ή όριο δαπανών ή χρήσης. Ελέγξτε τις λεπτομέρειες του σφάλματος πριν δοκιμάσετε ξανά ή αλλάξετε τις ρυθμίσεις χρέωσης.
Εντοπίστε την αιτία
Διαβάστε το μήνυμα σφάλματος και το error.code, όταν παρέχεται. Τα σφάλματα που σχετίζονται με τη χρέωση μπορεί επίσης να χρησιμοποιούν τη γενικότερη τιμή insufficient_quota στο πεδίο error.type.
| Σφάλμα ή κωδικός | Τι σημαίνει | Τι να κάνετε |
| Συμπληρώθηκε το όριο ρυθμού για αιτήματα ή token | Τα αιτήματα υπερβαίνουν ένα ισχύον όριο ρυθμού. | Μειώστε τον ρυθμό αποστολής αιτημάτων και ακολουθήστε τις παρακάτω οδηγίες επαναπροσπάθειας. |
| credit_balance_exhausted | Ο οργανισμός δεν έχει άλλες διαθέσιμες προπληρωμένες μονάδες. | Προσθέστε μονάδες στις ρυθμίσεις χρέωσης του API. |
| organization_usage_limit_exceeded | Ο οργανισμός έφτασε στο όριο χρήσης που του έχει ορίσει η OpenAI. | Ζητήστε έγκριση για υψηλότερο όριο χρήσης. |
| organization_spend_limit_exceeded | Ο οργανισμός έφτασε στο δεσμευτικό όριο δαπανών του. | Αυξήστε ή καταργήστε το όριο ή περιμένετε τη μηνιαία επαναφορά. |
| project_spend_limit_exceeded | Το έργο έφτασε στο δεσμευτικό όριο δαπανών του. | Αυξήστε ή καταργήστε το όριο του έργου ή περιμένετε τη μηνιαία επαναφορά. |
Η επαναπροσπάθεια μετά από σφάλμα χρέωσης, δαπανών ή ορίου χρήσης δεν αποκαθιστά την πρόσβαση. Αντιμετωπίστε πρώτα το πρόβλημα με το υπόλοιπο ή το όριο που αναφέρεται. Οι αλλαγές στα δεσμευτικά όρια δαπανών μπορεί να χρειαστούν χρόνο για να εφαρμοστούν.
Για να αλλάξετε ένα όριο δαπανών, χρειάζεστε δικαίωμα διαχείρισης των σχετικών ρυθμίσεων του οργανισμού ή του έργου. Αν δεν έχετε πρόσβαση, απευθυνθείτε στο άτομο που διαχειρίζεται αυτές τις ρυθμίσεις.
Για αγορές προπληρωμένων μονάδων, δείτε: Ρύθμιση και διαχείριση της προπληρωμένης χρέωσης του API.
Για τις διάφορες επιλογές ελέγχου δαπανών, δείτε τον οδηγό ορίων δαπανών του API.
Ελέγξτε τα ισχύοντα όρια ρυθμού
Μεταβείτε στη σελίδα Ορίων του οργανισμού σας για να ελέγξετε την τρέχουσα βαθμίδα χρήσης και τα όριά του.
Τα όρια ρυθμού μπορούν να ισχύουν σε επίπεδο οργανισμού και έργου. Δεν αποτελούν ατομικά όρια χρήσης για κάθε χρήστη. Τα όρια διαφέρουν επίσης ανά μοντέλο, ενώ ορισμένες οικογένειες μοντέλων μοιράζονται ένα κοινό όριο.
Ελέγξτε ποιο όριο αναφέρεται στο σφάλμα. Για παράδειγμα, τα αιτήματα ανά λεπτό και τα token ανά λεπτό έχουν ξεχωριστά όρια. Μπορεί να φτάσετε στο ένα όριο ενώ παραμένετε κάτω από το άλλο.
Ελέγξτε τα όρια του API δημιουργίας εικόνας
Τα όρια ρυθμού του API δημιουργίας εικόνας εξαρτώνται από το μοντέλο και τη βαθμίδα χρήσης σας. Επιλέξτε το μοντέλο σας στη σελίδα μοντέλων για να δείτε τα όριά του.
Για οδηγίες ρύθμισης, δείτε τον οδηγό δημιουργίας εικόνας για προγραμματιστές. Για περισσότερες πληροφορίες σχετικά με τις βαθμίδες χρήσης, δείτε τον οδηγό ορίων ρυθμού του API.
Επιβεβαιώστε ποιον οργανισμό χρησιμοποιεί το αίτημά σας
Αν ανήκετε σε πολλούς οργανισμούς, βεβαιωθείτε ότι τα αιτήματά σας χρησιμοποιούν τον οργανισμό και το έργο που θέλετε.
Όταν το κλειδί API σας χρησιμοποιεί προεπιλεγμένο οργανισμό, ελέγξτε τη ρύθμιση προεπιλεγμένου οργανισμού. Οι οργανισμοί μπορεί να έχουν διαφορετικές ρυθμίσεις χρέωσης και βαθμίδες χρήσης.
Μειώστε τα προσωρινά σφάλματα ορίου ρυθμού
Ρυθμίστε τον ρυθμό των αιτημάτων και αποφύγετε τις απότομες αυξήσεις
Κατανείμετε τα αιτήματα στον χρόνο αντί να στέλνετε πολλά ταυτόχρονα.
Τα όρια ρυθμού μπορούν να εφαρμόζονται σε μικρότερα χρονικά διαστήματα από το εμφανιζόμενο. Για παράδειγμα, ένα όριο 60 αιτημάτων ανά λεπτό μπορεί να εφαρμόζεται και σε διαστήματα του 1 δευτερολέπτου. Επομένως, μια σύντομη απότομη αύξηση των αιτημάτων μπορεί να προκαλέσει σφάλμα, ακόμη κι αν η μέση χρήση σας φαίνεται χαμηλότερη από το όριο ανά λεπτό.
Οι μεγάλες προτροπές και τα αδικαιολόγητα υψηλά όρια token εξόδου μπορούν επίσης να συμβάλουν σε σφάλματα ορίου ρυθμού token.
Περιμένετε πριν δοκιμάσετε ξανά
Για προσωρινά σφάλματα ορίου ρυθμού:
Ελέγξτε αν υπάρχει κεφαλίδα απόκρισης Retry-After.
Αν η κεφαλίδα περιέχει έγκυρο χρόνο αναμονής, περιμένετε τουλάχιστον αυτό το διάστημα πριν δοκιμάσετε ξανά.
Αν η κεφαλίδα λείπει ή δεν είναι έγκυρη, χρησιμοποιήστε εκθετική αύξηση του χρόνου αναμονής με τυχαία διακύμανση: αυξήστε τον χρόνο αναμονής μετά από κάθε αποτυχημένη προσπάθεια και προσθέστε μια μικρή τυχαία καθυστέρηση.
Περιορίστε τόσο τον αριθμό των επαναπροσπαθειών όσο και τον συνολικό χρόνο που αφιερώνετε σε αυτές.
Τα επίσημα SDK της OpenAI επαναλαμβάνουν ήδη τα αιτήματα για σφάλματα ορίου ρυθμού που επιτρέπουν επαναπροσπάθεια και τηρούν την κεφαλίδα Retry-After όταν υπάρχει. Λάβετε υπόψη αυτές τις επαναπροσπάθειες πριν προσθέσετε άλλον βρόχο επαναπροσπαθειών.
Τα αποτυχημένα αιτήματα συνυπολογίζονται στα όρια ανά λεπτό. Η συνεχής επαναποστολή του ίδιου αιτήματος μπορεί να παρατείνει το πρόβλημα.
Για οδηγίες υλοποίησης και παραδείγματα, δείτε τον οδηγό ορίων ρυθμού του API. Ελέγξτε κάθε βιβλιοθήκη επαναπροσπαθειών τρίτου μέρους πριν τη χρησιμοποιήσετε στην εφαρμογή σας.
Ελέγξτε το μέγεθος της προτροπής και της εξόδου
Αφαιρέστε από τις προτροπές σας περιττές οδηγίες, επαναλαμβανόμενες πληροφορίες πλαισίου και παραδείγματα. Δοκιμάστε την αναθεωρημένη προτροπή για να επιβεβαιώσετε ότι εξακολουθεί να παράγει το αποτέλεσμα που χρειάζεστε.
Χρησιμοποιήστε την παράμετρο token εξόδου που υποστηρίζουν το τελικό σημείο και το μοντέλο σας:
Το Chat Completions χρησιμοποιεί την παράμετρο max_completion_tokens.
Το Responses χρησιμοποιεί την παράμετρο max_output_tokens.
Αποφύγετε να ορίζετε πολύ υψηλότερο όριο από αυτό που χρειάζεται το αίτημα. Αυτές οι παράμετροι περιλαμβάνουν τόσο τα token συλλογιστικής όσο και την ορατή έξοδο, οπότε προβλέψτε επαρκές όριο και για τα δύο όταν χρησιμοποιείτε μοντέλο συλλογιστικής.
Ελέγξτε τη βαθμίδα χρήσης σας
Αν τα σφάλματα συνεχίζονται αφού περιορίσετε τις απότομες αυξήσεις αιτημάτων και ελέγξετε τη χρήση token, δείτε στη σελίδα Ορίων τους διαθέσιμους τρόπους αύξησης των ορίων σας.
Η βαθμίδα επί πληρωμή χρήσης του οργανισμού σας αναβαθμίζεται αυτόματα καθώς οι συνολικές αγορές μονάδων του φτάνουν στα απαιτούμενα ποσά για τις βαθμίδες Build, Launch και Grow. Οι υψηλότερες βαθμίδες παρέχουν γενικά υψηλότερα όρια ρυθμού. Δείτε τον οδηγό ορίων ρυθμού του API για τις προϋποθέσεις κάθε βαθμίδας.
Το εγκεκριμένο μηνιαίο όριο χρήσης σας είναι ξεχωριστό από τα όρια ρυθμού αιτημάτων και token. Η αύξηση του ενός δεν πρέπει να θεωρείται επιβεβαίωση ότι έχει αλλάξει και το άλλο.
Αν το πρόβλημα συνεχίζεται
Πριν ζητήσετε περαιτέρω υποστήριξη
Έχετε διαθέσιμα το ακριβές μήνυμα σφάλματος, τυχόν κωδικό σφάλματος, τα σχετικά αναγνωριστικά αιτημάτων, την ώρα του σφάλματος μαζί με τη ζώνη ώρας σας και το σχετικό όριο που εμφανίζεται στον λογαριασμό σας. Σημειώστε τα βήματα που έχετε ήδη δοκιμάσει.
Επικοινωνήστε με την Υποστήριξη της OpenAI
Επικοινωνήστε με την Υποστήριξη της OpenAI μέσω του Κέντρου Βοήθειας αν δεν μπορείτε να επιλύσετε το πρόβλημα αφού ελέγξετε το όριο που αναφέρεται. Μη συμπεριλάβετε κλειδιά API ή άλλα απόρρητα στοιχεία ελέγχου ταυτότητας.