Developer guide
Κωδικοί σφάλματος
Ενέργειες και κανόνες επανάληψης ανά κωδικό κατάστασης
Αυτή η σελίδα συνοψίζει τους κωδικούς κατάστασης που επιστρέφει η πύλη, τη σημασία τους και τις ενέργειες για κάθε κωδικό.
Όταν το upstream επιστρέφει 4xx ή 5xx, ο κωδικός προωθείται 그대로· στις υπόλοιπες περιπτώσεις ισχύει ο παρακάτω πίνακας.
Περιγράφονται επίσης η μορφή του σώματος σφάλματος για τα δύο πρότυπα συμβατότητας, οι κανόνες για το Anthropic-compatible error.type και η οθόνη της κονσόλας για τον έλεγχο των ορίων και της χρήσης.
Κωδικός κατάστασης
| Κωδικός | Σημασία | Ενέργεια |
|---|---|---|
| 400 | Μη έγκυρη τιμή αιτήματος. Το limit στη λίστα μοντέλων που είναι συμβατά με Anthropic είναι εκτός του εύρους 1~1000 ή επιχειρήθηκε συνέχιση αποθηκευμένης απόκρισης με GET /responses/{responseId}?stream=true | Διορθώστε την τιμή ώστε να βρίσκεται εντός του εύρους. Ανακτήστε τις αποθηκευμένες αποκρίσεις χωρίς stream. |
| 401 | Απουσιάζει το κλειδί ή το κλειδί έχει λήξει ή ανακληθεί | Ελέγξτε την κατάσταση του κλειδιού στη σελίδα κλειδιών API και επαληθεύστε το όνομα της κεφαλίδας και το πρόθεμα Bearer. |
| 403 | Δεν υπάρχει δικαίωμα πρόσβασης στο μοντέλο, έχει ξεπεραστεί το όριο χρήσης, δεν επαρκούν οι μονάδες ή δεν είστε ο κάτοχος της φωνής | Το error.message διακρίνει την αιτία. Τα αριθμητικά στοιχεία εμφανίζονται στην οθόνη της ενότητας «Έλεγχος ορίων και χρήσης» παρακάτω. |
| 404 | Το μοντέλο δεν υπάρχει ή δεν είναι προσβάσιμο με αυτό το κλειδί (συμπεριλαμβανομένων μοντέλων που δεν υποστηρίζονται πλέον), η διαδρομή δεν υπάρχει ή έχει παρέλθει η περίοδος διατήρησης 3 ημερών για τα αποτελέσματα του CleviDrive | Ελέγξτε πρώτα τη λίστα των μοντέλων που μπορούν να κληθούν με GET /models. Συγκρίνετε τη διαδρομή με τον πίνακα στη σελίδα «Πραγματοποίηση κλήσης API». |
| 408 · 409 · 413 | Χρονικό όριο upstream, συμφόρηση ή υπέρβαση μεγέθους αιτήματος. Για διαδρομές φωνής και Voice, το χρονικό όριο είναι 5 λεπτά και το ανώτατο μέγεθος αιτήματος 28 MiB | Αν το 409 περιλαμβάνει Retry-After, περιμένετε για το указанμένο χρονικό διάστημα. Για το 413, χωρίστε το αίτημα σε τμήματα. |
| 429 | Ο πάροχος upstream έχει επιβάλει περιορισμό ρυθμού | Αν υπάρχει Retry-After, ακολουθήστε το 그대로· διαφορετικά, επαναλάβετε με εκθετική οπισθοχώρηση. |
| 5xx | Προσωρινό σφάλμα της πύλης ή του upstream (συμπεριλαμβανομένου του 503) | Επαναλάβετε με εκθετική οπισθοχώρηση. Αν το πρόβλημα επαναλαμβάνεται, ενημερώστε μας μέσω της βοήθειας και της επικοινωνίας, μαζί με το X-Request-Id. |
Επανάληψη
Η πύλη δεν δημιουργεί δικά της 429 και δεν επαναλαμβάνει κρυφά τις αποκρίσεις upstream ούτε τις τοποθετεί σε ουρά.
Η αναμονή και η επανάληψη πραγματοποιούνται από τον client.
| Κώδικας | Χρόνος αναμονής | Στη συνέχεια |
|---|---|---|
| 409 | Εάν υπάρχει Retry-After, περιμένετε για αυτό το διάστημα | Στείλτε ξανά το ίδιο αίτημα. |
| 429 | Εάν υπάρχει Retry-After, περιμένετε για αυτό το διάστημα· διαφορετικά, χρησιμοποιήστε εκθετικό backoff | Στείλτε ξανά το ίδιο αίτημα. |
| 5xx | Εκθετικό backoff | Επικοινωνήστε μαζί μας εάν το πρόβλημα επαναλαμβάνεται. |
| 413 | Χωρίς αναμονή | Χωρίστε το αίτημα σε μικρότερα μέρη. |
Σώμα σφάλματος
Η μορφή του σώματος σφάλματος διαφέρει ανά προδιαγραφή. Για σφάλματα upstream, διατηρούμε μόνο το μήνυμα, το整理ζουμε και το προωθούμε· οι στοίβες και τα εσωτερικά πεδία δεν μεταβιβάζονται.
Αυτό είναι το σώμα της συμβατής με OpenAI διαδρομής.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Αυτό είναι το σώμα της συμβατής με Anthropic διαδρομής. Το error.type καθορίζεται από τον κωδικό κατάστασης.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Κωδικός κατάστασης | error.type |
|---|---|
| 400 | invalid_request_error |
| 401 | authentication_error |
| 403 | permission_error |
| 404 | not_found_error |
| 413 | request_too_large |
| 429 | rate_limit_error |
| 529 | overloaded_error |
| Άλλοι κωδικοί | api_error |
Έλεγχος ορίων και χρήσης
Οι τιμές των ορίων διαφέρουν ανά workspace. Αφού ελέγξετε την αιτία του 403 μέσω του error.message, δείτε τις τιμές στην παρακάτω οθόνη.
| Τι να ελέγξετε | Οθόνη κονσόλας |
|---|---|
| Το όριο που ισχύει για το workspace μου | Εκχωρημένο όριο χρήσης στην Επισκόπηση |
| Το εύρος που επιτρέπει το πρόγραμμα και το υπόλοιπο | Πρόγραμμα και πιστώσεις |
| Πραγματική χρήση (κλήσεις ανά μοντέλο και κλειδί, εκτιμώμενες πιστώσεις που θα αφαιρεθούν) | Χρήση |
| Κατάσταση κλειδιού (αν έχει λήξει ή ανακληθεί) | Κλειδί API |