Σφάλματα

Κωδικοί σφάλματος HTTP, μορφές απόκρισης και κανόνες επανάληψης.

HTTP	Εννοια	Συνιστώμενη δράση
400	Μη έγκυρο αίτημα	Διορθώστε το JSON και τα υποχρεωτικά πεδία
401	Μη έγκυρο, παγωμένο ή ανακλημένο κλειδί	Περιστρέψτε ή ξεπαγώστε το κλειδί
402	Συμπληρώθηκε ανεπαρκές υπόλοιπο λογαριασμού ή όριο χρήσης κλειδιού	Προσθέστε χρήματα ή επαναφέρετε/αυξήστε το όριο κλειδιού
403	Το μοντέλο δεν είναι διαθέσιμο για το κλειδί ή την IP πηγής που απορρίφθηκε από μια λίστα επιτρεπόμενων API	Ενημερώστε τα δικαιώματα κλειδιού ή χρησιμοποιήστε μια επιτρεπόμενη IP πηγής
404	Άγνωστο τελικό σημείο, μοντέλο ή αίτημα ασυγχρονισμού	Ελέγξτε το αναγνωριστικό και τη διαδρομή
413	Πολύ μεγάλο αίτημα	Μειώστε το μέγεθος του περιβάλλοντος
429	Υπέρβαση στροφών ανά λεπτό ή συγχρονισμού	Τιμή `Retry-After`
500	Σφάλμα πύλης	Δοκιμάστε ξανά και επιθεωρήστε τα αρχεία καταγραφής
502/503/504	Το Upstream δεν είναι διαθέσιμο ή έχει λήξει	Δοκιμάστε ξανά με εκθετική υποχώρηση

Απαιτείται πληρωμή

Ανεπαρκές υπόλοιπο εταιρείας/λογαριασμού επιστρέφει HTTP 402 Payment Required στον φάκελο συμβατό με OpenAI:

{
  "error": {
    "message": "Insufficient account balance.",
    "type": "payment_required",
    "code": "insufficient_balance"
  }
}

Ο ίδιος σταθερός λόγος/κωδικός καταγράφεται στο Ιστορικό αιτημάτων. ΕΝΑ 402 Το αίτημα απορρίπτεται πριν από την εκτέλεση του παρόχου και δεν θα πρέπει να επαναληφθεί αυτόματα μέχρι να διορθωθεί η χρηματοδότηση ή ο ισχύων περιορισμός δαπανών.

Απόρριψη λίστας επιτρεπόμενων IP

Όταν ένα πιστοποιημένο κλειδί API είναι έγκυρο αλλά η διεύθυνση προέλευσης βρίσκεται εκτός της πραγματικής λίστας επιτρεπόμενων API προσωπικού ή επιχειρηματικού οργανισμού, το Model Gate απορρίπτει το αίτημα πριν από την ανάντη εκτέλεση. Οι αποκρίσεις συμβατές με OpenAI χρησιμοποιούν HTTP 403 με κωδικό ip_not_allowed. Οι αποκρίσεις συμβατές με Anthropic χρησιμοποιούν το φάκελο σφαλμάτων Anthropic με HTTP 403 και authentication_error. Μην προσπαθήσετε ξανά από την ίδια μη επιτρεπόμενη πηγή. αλλάξτε τη διαμορφωμένη λίστα επιτρεπόμενων παραμέτρων ή στείλτε το αίτημα από μια επιτρεπόμενη διεύθυνση.

Δοκιμάζω πάλι 429 μετά Retry-After. Δοκιμάζω πάλι 500, 502, 503, και 504 έως και τρεις φορές με οπισθοδρόμηση 1/2/4 δευτερολέπτου. Μην επαναλάβετε αυτόματα επικύρωση, έλεγχο ταυτότητας, ισορροπία ή σφάλματα που δεν βρέθηκαν.

Χρησιμοποιήστε το δημόσιο αναγνωριστικό αιτήματος από X-Request-ID για να συσχετίσετε την απάντηση με το αρχείο καταγραφής αιτημάτων.

Σφάλματα μετά τις κεφαλίδες ροής

Το SSE μπορεί να αποτύχει μετά την αποστολή του HTTP200. Στη συνέχεια, η απάντηση περιέχει ένα συμβάν σφάλματος συμβατό με το πρωτόκολλο. το ιστορικό αιτημάτων πύλης καταγράφει την αστοχία τερματικού ανεξάρτητα από την κατάσταση του καλωδίου. Τα άγνωστα μηνύματα upstream είναι κρυμμένα από προεπιλογή, τα εγκεκριμένα μηνύματα ενδέχεται να εκτίθενται από την πολιτική του διαχειριστή και η πλήρης έκθεση σφαλμάτων στο upstream είναι ρητή. Τα εσωτερικά upstream μεταδεδομένα και τα προσωρινά ακατέργαστα παραμένουν μόνο για διαχειριστή. Η χρήση που λείπει μετά από μια διακοπτόμενη ροή είναι άγνωστη/απαιτείται έλεγχος, όχι μια αυτόματη εκτίμηση από byte καλωδίων. Διατηρήστε το αναγνωριστικό αιτήματος και δοκιμάστε ξανά σκόπιμα μόνο αφού ελέγξετε τη μερική έξοδο.