Επισκόπηση
Η χρήση του 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 χρησιμοποιεί έναν προεπιλεγμένο οργανισμό, ελέγξτε τη ρύθμιση προεπιλεγμένου οργανισμού. Διαφορετικοί οργανισμοί μπορεί να έχουν διαφορετικές ρυθμίσεις χρέωσης και βαθμίδες χρήσης.
Μειώστε τα προσωρινά σφάλματα ορίου ρυθμού
Κατανείμετε χρονικά τα αιτήματα και αποφύγετε τις αιχμές
Κατανείμετε τα αιτήματα στον χρόνο αντί να στέλνετε πολλά ταυτόχρονα.
Τα όρια ρυθμού μπορεί να επιβάλλονται σε μικρότερες περιόδους από το εμφανιζόμενο χρονικό διάστημα. Για παράδειγμα, ένα όριο 60 αιτημάτων ανά λεπτό μπορεί να επιβάλλεται και σε περιόδους του 1 δευτερολέπτου. Επομένως, μια σύντομη αιχμή μπορεί να προκαλέσει σφάλμα, ακόμη και αν η μέση χρήση σας φαίνεται χαμηλότερη από το όριο ανά λεπτό.
Οι μεγάλες προτροπές και τα αδικαιολόγητα υψηλά όρια token εξόδου μπορούν επίσης να συμβάλουν σε σφάλματα ρυθμού token.
Δοκιμάστε ξανά μετά από καθυστέρηση
Για προσωρινά σφάλματα ορίου ρυθμού:
Ελέγξτε αν υπάρχει κεφαλίδα απόκρισης Retry-After.
Αν η κεφαλίδα περιέχει έγκυρη διάρκεια καθυστέρησης, περιμένετε τουλάχιστον τόσο πριν προσπαθήσετε ξανά.
Αν η κεφαλίδα λείπει ή δεν είναι έγκυρη, χρησιμοποιήστε εκθετική υποχώρηση με τυχαιοποίηση: αυξήστε την καθυστέρηση μετά από κάθε αποτυχημένη προσπάθεια και προσθέστε μια μικρή τυχαία καθυστέρηση.
Περιορίστε τόσο τον αριθμό των επαναλήψεων όσο και τον συνολικό χρόνο που αφιερώνεται σε αυτές.
Τα επίσημα SDK της OpenAI επαναλαμβάνουν ήδη τα κατάλληλα αιτήματα που αποτυγχάνουν λόγω ορίου ρυθμού και τηρούν την κεφαλίδα Retry-After, όταν υπάρχει. Λάβετε υπόψη αυτές τις επαναλήψεις πριν προσθέσετε άλλον βρόχο επανάληψης.
Τα ανεπιτυχή αιτήματα συνυπολογίζονται στα όρια ανά λεπτό. Η συνεχής επανυποβολή του ίδιου αιτήματος μπορεί να παρατείνει το πρόβλημα.
Για οδηγίες και παραδείγματα υλοποίησης, ανατρέξτε στον οδηγό ορίων ρυθμού API. Ελέγξτε προσεκτικά οποιαδήποτε βιβλιοθήκη επαναλήψεων τρίτου μέρους προτού τη χρησιμοποιήσετε στην εφαρμογή σας.
Ελέγξτε το μέγεθος της προτροπής και της εξόδου
Αφαιρέστε τις περιττές οδηγίες, το επαναλαμβανόμενο περιεχόμενο και τα παραδείγματα από τις προτροπές σας. Δοκιμάστε την αναθεωρημένη προτροπή για να επιβεβαιώσετε ότι εξακολουθεί να παράγει το αποτέλεσμα που χρειάζεστε.
Χρησιμοποιήστε την παράμετρο token εξόδου που υποστηρίζεται από το τελικό σημείο και το μοντέλο σας:
Το Chat Completions χρησιμοποιεί την παράμετρο max_completion_tokens.
Το Responses χρησιμοποιεί την παράμετρο max_output_tokens.
Αποφύγετε να ορίσετε όριο πολύ μεγαλύτερο από αυτό που απαιτεί το αίτημα. Αυτές οι παράμετροι περιλαμβάνουν τόσο τα token συλλογιστικής όσο και την ορατή έξοδο, επομένως προβλέψτε χώρο και για τα δύο όταν χρησιμοποιείτε μοντέλο συλλογιστικής.
Ελέγξτε τη βαθμίδα χρήσης σας
Αν τα σφάλματα συνεχίζονται αφού μειώσετε τις αιχμές και ελέγξετε τη χρήση token, ανατρέξτε στη σελίδα Όρια για τους διαθέσιμους τρόπους αύξησης των ορίων σας.
Καθώς αυξάνονται οι δαπάνες API, η OpenAI μπορεί να αναβαθμίσει αυτόματα έναν οργανισμό σε υψηλότερη βαθμίδα χρήσης. Αυτό συνήθως αυξάνει τα όρια ρυθμού στα περισσότερα μοντέλα.
Το εγκεκριμένο μηνιαίο όριο χρήσης σας είναι ανεξάρτητο από τα όρια ρυθμού αιτημάτων και token. Η αύξηση του ενός δεν πρέπει να θεωρείται επιβεβαίωση ότι άλλαξε και το άλλο.
Αν το πρόβλημα συνεχίζεται
Πριν ζητήσετε περαιτέρω βοήθεια
Έχετε διαθέσιμα το ακριβές μήνυμα σφάλματος, τυχόν κωδικό σφάλματος, τα σχετικά αναγνωριστικά αιτημάτων, την ώρα του σφάλματος μαζί με τη ζώνη ώρας σας και το σχετικό όριο που εμφανίζεται στον λογαριασμό σας. Καταγράψτε τα βήματα που έχετε ήδη δοκιμάσει.
Επικοινωνήστε με την Υποστήριξη της OpenAI
Επικοινωνήστε με την Υποστήριξη της OpenAI μέσω του Κέντρου Βοήθειας, αν δεν μπορείτε να επιλύσετε το πρόβλημα αφού ελέγξετε το αναφερόμενο όριο. Μην συμπεριλάβετε κλειδιά API ή άλλα μυστικά ελέγχου ταυτότητας.