Έγγραφα προγραμματιστή UlazAI
Λάθη και όρια βίντεο
Όρια επικύρωσης και ενσωμάτωσης
Επιβολή επικύρωσης από την πλευρά του πελάτη πριν από την αποστολή αιτημάτων. Οι περισσότερες αποτυχίες έρχονται από μη έγκυρους συνδυασμούς μοντέλων (διάρκεια, αναλογία, ποιότητα ή τύπος εισόδου).
Συνήθεις απαντήσεις HTTP
| Κωδικός | Σημασία | Τυπική αιτία |
|---|---|---|
400 |
Μη έγκυρο αίτημα | Μη υποστηριζόμενη αναλογία/διάρκεια/ποιότητα, λείπει prompt, μη έγκυρη διεύθυνση URL |
401 |
Μη εξουσιοδοτημένο | Λείπει η περίοδος λειτουργίας ή το πλαίσιο ελέγχου ταυτότητας API |
402 |
Απαιτείται πληρωμή | Ανεπαρκείς πιστώσεις για ζητούμενη ομάδα εργασίας |
404 |
Δεν βρέθηκε | Άγνωστο μοντέλο γυμνοσάλιαγκας ή άγνωστο αναγνωριστικό εργασίας |
429 |
Περιορισμένη τιμή | Υπέρβαση των ορίων αιτημάτων ανά χρήστη |
Προστατευτικά ειδικά για το μοντέλο
model_slugπρέπει να υπάρχει στο μήτρα μοντέλου βίντεο.aspect_ratioκαιduration_secondsπρέπει να ταιριάζει ακριβώς με τις επιλογές του μοντέλου.quality_modeαπαιτείται όταν ένα μοντέλο έχει προεπιλογές ποιότητας.- Το Hailuo 2.3 απαιτεί ένα
input_image_urlsεισαγωγή και δεν υποστηρίζει δύο εικόνες. wan_2_6_v2vαπαιτεί έναinput_video_urlsείσοδος.- Το Kling 3.0 υποστηρίζει προαιρετικό
start_frame_url,end_frame_url, καιelementsμε αυστηρή επικύρωση σχήματος. - Το μέγεθος παρτίδας περιορίζεται σε 4 εργασίες ανά αίτημα.
Όρια μήκους Prompt
- Kling 3.0 και Kling 2.6: 2500 χαρακτήρες.
- Grok Imagine Video: 5000 χαρακτήρες.
- Hailuo 2.3 Standard/Pro: 5000 χαρακτήρες.
- Τα περισσότερα μοντέλα που απομένουν ακολουθούν την τυπική επικύρωση prompt στις υπηρεσίες παραγωγής.
Όρια ποσοστών
/api/v1/video-studio/generate/: 24 αιτήματα POST ανά χρήστη ανά ώρα.- Τελικά σημεία εργαλείου Video Studio: 24 αιτήματα POST ανά χρήστη ανά ώρα.
- Veo 3.1 ενέργειες επέκτασης και αναβάθμισης: 48 αιτήματα POST ανά χρήστη ανά ώρα.
Δοκιμάστε ξανά τη στρατηγική
- Μην προσπαθήσετε ξανά
400ή404χωρίς επιδιόρθωση δεδομένων αιτήματος. - Μην προσπαθήσετε ξανά
402έως ότου ο λογαριασμός έχει αρκετές πιστώσεις. - Επανάληψη
429με backoff και σεβασμό των ορίων ρυθμού διακομιστή. - Για παροδικές αποτυχίες, δοκιμάστε ξανά μόνο αφού ελέγξετε την τρέχουσα κατάσταση της εργασίας για να αποφύγετε διπλότυπα.