Μετάβαση στο περιεχόμενο

Έγγραφα προγραμματιστή UlazAI

Λάθη και όρια

Διαχείριση σφαλμάτων και όρια πλατφόρμας

Χρησιμοποιήστε δομημένο χειρισμό για σφάλματα API και επικυρώστε εισόδους από την πλευρά του πελάτη για μείωση επαναλαμβάνει.

Συνήθεις απαντήσεις HTTP

Κωδικός Σημασία Τυπική αιτία
400 Μη έγκυρο αίτημα Λείπει prompt, μη υποστηριζόμενο μέγεθος, μη έγκυρες παράμετροι μοντέλου
401 Μη εξουσιοδοτημένο Λείπει ή δεν είναι έγκυρο κλειδί/κουπόνι περιόδου λειτουργίας API
402 Απαιτείται πληρωμή Ανεπαρκείς αγορασμένες πιστώσεις ή περιορισμός πρόσβασης API
403 Απαγορευμένο Τα τελικά σημεία εγγραφής/σύνδεσης API είναι σκόπιμα απενεργοποιημένα
404 Δεν βρέθηκε Το αναγνωριστικό γενιάς δεν ανήκει στον τρέχοντα χρήστη ή αναντιστοιχία τελικού σημείου
500 Σφάλμα διακομιστή Αποτυχία ανάντη παρόχου ή λήξη χρόνου δικτύου

Ζητήστε όρια για την επιβολή από την πλευρά του πελάτη

  • prompt: μέγιστο 5000 χαρακτήρες σε ενοποιημένο τελικό σημείο.
  • image_urls: μέγιστο 14 URL σε ενοποιημένο τελικό σημείο.
  • size: συγκεκριμένο μοντέλο, επικύρωση έναντι μήτρα μοντέλου.
  • quality: τιμές για συγκεκριμένο μοντέλο για Seedream 5 Lite, Nano Banana 2, Ideogram και Qwen.
  • Η χρήση του API απαιτεί αγορασμένες πιστώσεις. Οι πιστώσεις καλωσορίσματος είναι μόνο για ιστότοπους.

Δοκιμάστε ξανά τη στρατηγική

Προτεινόμενη συμπεριφορά παραγωγής:

  • Μην προσπαθήσετε ξανά 400, 401, 402, ή 403 χωρίς αλλαγή εισόδου ή ταυτότητας.
  • Επανάληψη 500 με εκθετική υποχώρηση και αδυναμία κλειδιά στο επίπεδο της εφαρμογής σας.
  • Τελικό σημείο κατάστασης δημοσκόπησης πριν από την έναρξη διπλότυπων εργασιών παραγωγής.